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PREFACE 


0.1 MANUAL OBJECTIVES AND READER CLASS ASSUMPTIONS 


This manual is designed to provide all information necessary to 
interface directly with the I/O device drivers supplied as part of the 
RSX-11M system. It is intended for use by experienced RSX-11M 
programmers who want to take advantage of the time and/or space 
savings which result from direct use of the I/O drivers. . 


The orientation of this manual is tutorial, but it does not attempt to 
introduce the reader to all areas of RSX-11M input/output operations. 
Readers are expected to be familiar with the RSX-11M Executive 
Reference Manual (DEC-11-OMERA-A-D) and to have some experience with 
the Task Builder and either FORTRAN IV or MACRO-11 assembly language. 
Readers should also be familiar with the PDP-1l1 terminology presented 
in the PDP-1l1 Processor Handbook and the PDP-1l Peripherals Handbook. 
Users of RSX-11M who do not require such detailed knowledge of the I/O 
drivers can use the device independent services provided by File 
Control Services (FCS) as documented in the RSX-11 I/O Operations 
Reference Manual (DEC-11-OMFSA~A-D). 


0.2 STRUCTURE OF THE DOCUMENT 
This manual has three basic components: 


1. Chapter 1 provides an overview of RSX-11M input/output 
operations. It introduces the reader to the use of logical 
unit numbers, directive parameter blocks, and macro calls. 
It describes all of the I/O functions common to a variety of 
devices, and summarizes standard error and status conditions 
relating to completion of I/O requests. 
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2. Chapters 2 through 12 describe the use of all device drivers e 


supported by RSX-11M. These include the following: ( 
Chapter Device 
2 Terminals and terminal 


communications line interfaces 
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3 Disks 

4 DECtape 

5 Magnetic tape 

6 Cassette 

7 | Line printer 

8 | Card reader ae 
9 7 - Message-oriented communications | 


line interfaces 


10. Analog-to-digital converters 
Al - Universal digital controller | H 

7 : - rae eos ae ee i 
12 | : _ Laboratory Prreensnae system | 


Each of these chapters is etractured in “similar fashion and focuses on 
the fottoutng basic elements : = ; 


. Description of the aeice, including physical information. on 
speed, capacity, access, and usage 


- Summary of standard functions supported by the devices and 
descriptions of device-specific functions 


Discussion of special characters, carriage control codes, and 
functional HET ACEGRASELCED if relevant 
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Summary of error and status conditions returned on acceptance 
or rejection of I/O requests 
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- Description of programming hints for. users of the device 
under RSX-11M 
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3. Appendixes A through D provide quick reference material on 
I/O functions and status codes, a glossary of RSX-11M terms, 
and an example of RSX-11M I/O operations. These include the 


following: 
Appendix Contents 

A Summary of I/O functions 
by device 

B I/O function and status 
codes 

Cc Programming example 

D- Glossary of RSX-11M terms 


0.3 CONVENTIONS USED IN THIS MANUAL 

There are a number of conventions and assumptions used in this manual 
to present syntax and presran coding examples. These are described in 
the following list. 


l. Brackets ({]) in syntactic models enclose optional 
parameters. 


The following example illustrates this format: 
ASTX$S [err] 


2. Braces ({ . ) in syntactic models indicate that one of the 
. items must be selected, as in the following: 


DOM 
CALL (inm,icont,idata, [idx] , [isb], [lun] ) 

DOMW 

3. An ellipsis (...) in a syntactic model or coding example 

indicates that parameters have been omitted. As used in this 
manual, an ellipsis in a QIO macro call indicates omission of 
standard QIO parameters described in section 1.4. This is 
illustrated below: 

QIO$C IO.RLV,...,<stadd,size> 


4. Consecutive . commas in a coding example indicate null 
arguments. The following illustrates this usage: 


QIosc I0O.ATT,6,,,,ASTO1 


5. Commas indicating null trailing optional arguments may be 
omitted, as in the following: 


QIO$C I0O.KIL,9. 
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Certain parameters are required but ignored by RSX-11M; this 
is necessary to maintain compatibility with RSX-11D. For 
example, in the following, the priority specification (fourth 
parameter) is ignored: 


QIOSC IO.WLB,8.,EV,,1IOSB,ASTX,<IOBUF , NBUF> 


With the exception of MACRO-1l coding examples, all numbers 
in the text of this manual are assumed to be decimal; octal 
radix is explicitly declared as in the following: 


An illegal logical block number has been specified for 
DECtape. The number exceeds 577 (1101 octal). 


In MACRO-1l1 coding examples, all numbers are assumed to be 
octal; decimal radix is explicitly designated by following 
the number with a decimal point, as in the following example: 


QIO$C I0.RDB,14.,,,10SB,,<IOBUF,80.> 


In FORTRAN subroutine models, parameters which begin with the 
letters i through n indicate integer variables, as in the 
following example: 


CALL DRS (ibuf,ilen,imode,irate,iefn,imask,isb, 
{nbuf],istart], [istop] ) 


In general, where both i and n prefixes are used in a call, 
the i form indicates the name of an array and the n form 
specifies the size of the array. . 


All integer arrays and variables are assumed to occupy one 
storage word per variable (i.e., INTEGER*2) and all real 
arrays and variables are assumed to occupy two storage words 
per variable (i.e., REAL*4). 
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CHAPTER 1 


RSX-11M INPUT/OUTPUT 


1.1 OVERVIEW OF RSX=-11M I/O 


The RSX-11M real-time Executive supports a wide variety of PDP-1l 
input and output devices, including disks, DECtapes, magnetic tapes, 
tape cassettes, line printers, card readers, and such laboratory and 
industrial devices as analog-to-digital converters, universal digital 
controllers, and laboratory peripheral systems. Drivers for these 
devices are supplied by Digital Equipment Corporation as part of the 
RSX-11M system software. This manual describes all of the device 
drivers supported by RSX-11M and the characteristics, functions, error 
conditions, and programming hints associated with each. PDP=-11 
devices not described in this manual can be added to basic RSX-11M 
configurations, but users must develop and maintain their own drivers 
for these devices. 


Input/foutput operations under RSX-11M are extremely flexible and are 
as device- and function-independent as possible. Programs issue I/O 
requests to logical units which have been previously associated with 
particular physical device units. Each program or task is able to 
establish its own correspondence between physical device units and 
logical unit numbers (LUNs). I/O requests are queued as issued; they 
are subsequently processed according to the relative priority of the 
tasks which issued them. I/O requests can be issued from MACRO=-11 or 
FORTRAN tasks by means of the File Control Services (for appropriate 
devices), or can be interfaced directly to an I/O driver by means of 
the QIO system directive. 


All of the I/O services described in this manual are requested by the 
user in the form of QIO system directives. A function code included 
in the QIO directive indicates the particular input or output 
operation to be performed. I/O functions can be used to request such 
operations as3 


- attaching or detaching a task's exclusive use of a physical 
device unit 


- reading or writing a logical or virtual block of data 
- canceling a task's I/O requests 
A wide variety of device-specific input/output operations (e.g., 


reading DECtape in reverse, rewinding cassette tape) can also be 
specified via QIO directives. 
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1.2 RSX-11M DEVICES 


The devices listed below are supported by RSX-11M. Drivers are 
supplied for each of these devices, and I/O operations for them are 
described in detail in subsequent chapters of this manual. 


1. A variety of terminals, including the following: 


ASR-33 and ASR~35 Teletypes (1) 
KSR-33 and KSR=-35 Teletypes (1) 

LA30 DECwriters (serial and parallel) 
LA36 DECwriter 

VT05B Alphanumeric Display Terminal 


vT50 Alphanumeric Display Terminal 


RTO2 Data Entry Terminal 


RTO2-C Badge Reader and Data Entry Terminal 


These terminals are supported on the following asynchronous 
line interfaces: 


DJ11 Asynchronous Communications Line Interface Multiplexer 


DH11 and DH11-DM11-BB Asynchronous Communications Line 
Interface Multiplexer 


DL11-A, DL11=B, DL11=-C, and DL11=-D Asynchronous 
Communications Line Interfaces 


variety of disks, including the following: 


RF11/RS11 Fixed-Head Disk 


(1) Teletype is a registered trademark of the Teletype Corporation. 
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10. 


Lis 


- RJPO4 Pack Disk 

« RJSO3 Fixed-Head Disk 

- RJSO4 Fixed-Head Disk 

e RK11/RKO5 Cartridge Disk 
« RP11-C/RPO03 Pack Disk 


TC11<-G DECtape 


Two types of magnetic tape: 


« TJU16 Magnetic Tape 

« TM11/TU10 Magnetic Tape 

TALL Tape Cassette 

Three line printers: 

- LP1l Line Printer 

- LS11 Line Printer 

e LV11 Line Printer 

CR11 Card Reader 

Synchronous and asynchronous line ineeeeacas:. 
- DL11-E Asynchronous Communication Line Interface 
« DP1l Synchronous Communication Line Interface 
« DULL Synchronous Communication Line Interface 
Two analog-to-digital converters: 

- AFC11 Analog-to-Digital Converter 

- ADOI=-D Analog-to=Digital Converter 

UDC1l Universal Digital Controller 


LPS11 Laboratory Peripheral System 
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1.3 LOGICAL UNITS 


This section describes the construction of the logical unit table and 
the use of logical unit numbers. 


1.3.1 Logical Unit Number 


A logical unit number or LUN is a number which is associated with a 
physical device unit during RSX-11M I/O operations. For example, LUN 
1 might be associated with one of the terminals in the system, LUNs 2, 
3, 4, and 5 with DECtape drives, and LUNs 6, 7, and 8 with disk units. 
The association is a dynamic one; each task running in the system can 
establish its own correspondence between LUNs and physical device 
units, and can change any LUN=-physical device unit association at any 
time. The flexibility. of this association contributes heavily to 
RSX-11M device independence. 


A logical unit number is simply a short name used to represent a 
logical unit-physical device unit association. Once the association 
has been made, the LUN provides a direct and efficient mapping to the 
physical device unit, and eliminates the necessity to search the 
device tables whenever the system encounters a reference to a physical 
device unit. 


The user should remember that, although a LUN-physical device unit 
association can be changed at any time, reassignment of a LUN at run 
time causes pending I/O requests for the previous LUN assignment to be 
cancelled. It is the user's responsibility to verify that all 
outstanding I/O requests for a LUN have been serviced before that LUN 
is associated with another physical device unit. 


1.3.2 Logical Unit Table 


There is one logical unit table (LUT) for each task running in an 
RSX-11M system. This table is a variable-length block contained in 
the task header. Each LUT contains sufficient 2-word entries for the 
number of logical units specified by the user at task build time. 


Each entry or slot contains a pointer to the physical device unit 
currently associated with that LUN. Whenever a user issues an I/O 
request, RSX-11M matches the appropriate physical device unit to the 
LUN specified in the call by indexing into the logical unit table by 
the number supplied as the LUN. Thus if the call specifies 6 as_ the 
LUN, RSX-11M accesses the sixth 2-word entry in the LUT and associates 
the I/O request with the physical device unit to which the entry 
points. The number of LUN assignments valid for a task ranges from 
zero to 255, but cannot be greater than the number of LUNs’ specified 
at task build time. 


Figure 1-1 illustrates a typical logical unit table. 
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Number of LUNs 


UCB 
LUN 1 
LUN 2 

UCB 
LUN 3 
LUN 4 . UCB 


Figure l-l 
Logical Unit Table 


Word 1 of each active (assigned) 2-word entry in the logical unit 
table points to the unit control block (UCB) of the physical device 
unit with which the LUN is’ associated. This linkage may be 
indirect - that is, the user may force redirection of references from 
one unit to another unit via the MCR command, REDIRECT. Word 2 of 
each entry is reserved for mountable devices. _ 


1.3.3 Changing LUN Assignments 


Logical unit numbers have no significance until they are associated 
with a physical device unit by means of one of the methods described 
below: 


1. At task build time, the user can specify an ASG keyword 
option, which associates a physical device unit with a 
logical unit number referenced in the task being built. 


2. The user or system operator can issue a REASSIGN command to 
MCR} this command reassigns a LUN to another physical 
device unit and thus changes the LUN-physical device unit 
correspondence. Note that this reassignment has no effect 
on the in=-core image of a task. 


3. At run time, a task can dynamically change a LUN assignment 
by issuing the ASSIGN LUN system directive, which changes 
the association of a LUN with a physical device unit during 
task execution. 
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1.4 ISSUING AN I/O REQUEST 


User tasks perform I/O in the RSX=-11M system by submitting requests 
for I/O service in the form of QIO system directives. See Chapter. 2 
of the RSX-11M Executive Reference Manual for a complete description 
of RSX-11M system directives. 


In RSX-11M, as in most multiprogramming systems, tasks do not normally 
access physical device units directly. Instead, they utilize 
input/output services provided by the Executive, since it can 
effectively multiplex the use of physical device units over many 
users. The RSX-11M Executive routes I/O requests to the appropriate 
device driver and queues them according to the priority of the 
requesting task. I/O operations proceed concurrently with other 
activities in an RSX-11M system. 


After an I/O request has been queued, the system does not wait for the 
operation to complete. If at any time the user task which issued the 
QIO request cannot proceed until the I/O operation has completed, it 
should specify an event flag (see sections 1.4.1 and 1.4.2) in the QIO 
request and should issue a WAITFOR system directive which specifies 
the same event flag at the point where synchronization must occur. 
The task then waits for completion of 1/0 by waiting for the specified 
event flag to be set. 


Each QIO directive must supply sufficient information to identify and 
queue the I/0 request. The user may also want to include parameters 
to receive error or status codes and to specify the address of an 
asynchronous system trap service routine, Certain types of I/0 
operations require the specification of device-dependent information 
as well. Typical QIO parameters are the following: 


- I/O function to be performed 


» sogical unit number associated with the physical device unit 
to be accessed 


° Optional event flag number for synchronizing I/O completion 
processing 


- Optional address of the I/O status block to which information 
indicating successful or unsuccessful completion is returned 


- Optional address of an asynchronous system trap service 
routine to be entered on completion of the I/O request 


« Optional device- and function-dependent parameters specifying 
such items as the starting address of a data buffer, the size 
of the buffer, and a block number 


A set of system macros which facilitate the issuing of QIO directives 
is supplied with the RSX-11M svstem. These macros, which reside in 
the System Macro Library (SY¥:[1,1]RSXMAC.SML), must be made available 
to the invoking task by means of the MACRO-J1 Assembler directive 
eMCALL. The function of .MCALL is described in section 1.6.3. 


aS 


ss "SESE SESS SEES SS SEE SSSR ESSE SSS PSSST SS ESD EEE STE SE TTS ETE BE EES LET EEE TER EGE EOE LTE LTC ED ERIE ESS EEA EE ERT OE ETT 


Re pestmann eee 


( 
% 


“re sa mye 


CHAPTER 1. RSX=-11M INPUT/OUTPUT 


Several of the first six parameters in the QIO directive are optional, 
but space for these parameters must be reserved. 


During expansion of a QIO macro, a value of zero is defaulted for all 
null (omitted) parameters. Inclusion of the device- and 
function-dependent parameters depends on the physical device unit and 
function specified. If the user wanted to specify only an I/O 
function code, a LUN, and an address for an asynchronous system trap 
service routine, the following might be issued: 


QIO$SC I0.ATT,6,,,,ASTOX 


where IO.ATT is the I/O function code for attach, 6 is the LUN, ASTOX 
is the AST address, and commas hold places for the event flag number, 
the request priority, and the address of the I/O status block. No 
additional device- or function-dependent parameters are required for 
an attach function. The C form of the QIOS macro is used here and in 
most of the examples included in Chapter 1. Section 1.5 describes the 
three legal forms of the macro, 


For convenience, any comma may be omitted if no parameters appear to 
the right of it. The command above could therefore be issued as 
follows, if the asynchronous system trap was not desired. 

QIOSC IO.ATT,6 


All extra commas have been dropped. If, however, a parameter appears 
to the right of any place-holding comma, that comma must be retained. 


1.4.1 QIO Macro Format 
The arguments for a specific QIO macro call may be different for each 
I/O device accessed and for each I/O function requested. The general 


format of the call is, however, common to all devices and is as 
follows: 


QIOSC fne,lun,[efn], [pri], {isb], [ast], [<pl,p2,...,p6>] 


where brackets ({]) enclose optional or functicon-dependent parameters, 


If function-dependent parameters (pl,...,p6) are required, these 


parameters must be enclosed within angle brackets (<>). The following 
paragraphs summarize the use of each QIO parameter. Section 1.5 
discusses different forms of the QIOS$ macro itself. 


The fne parameter is a symbolic name representing the I/O function to 
be performed. This name is of the form: 


IO.XxXX 
where xxx identifies the particular I/O operation. For example, a QIO 
request to attach the physical device unit associated with a LUN 
specifies the function code: 


IO,ATT 
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A QIO request to cancel (or kill) all I/O requests for a specified LUN 
begins in the following way: 


QIOSC IO.KIL,... 


The fnce parameter specified in the QIO request is stored internally as 
a function code in the high-order byte and modifier bits in the 
low-order byte of a single word. The function code is in the range 
zero through 31 and is a binary value supplied by the system to match 
the symbolic name specified in the QIO request. The correspondence 
between global symbolic names and function codes is defined in the 
system object module library. Local symbolic definitions may also be 
obtained via the FILIO$ and SPCIOS macros which reside in the System 
Macro Library and are summarized in Appendix A. Several similar 
functions may have identical function codes, and may be distinguished 
only by their modifier bits. For example, the DECtape read logical 
forward and read logical reverse functions have the same function 
code. Only the modifier bits for these two operations are _ stored 
differently. 


The lun parameter represents the logical unit number (LUN) of the 
associated physical device unit to be accessed by the I/O request. 
The association between the physical device unit and the LUN is 
specific to the task which issues the I/O request, and the LUN 
reference is usually device-independent. An attach request to the 
physical device unit associated with LUN 14 begins in the following 
way: 


QIOSC IO.ATT,14.,... 


Because each task has its own logical unit table (LUT) in which the 
physical device unit-LUN correspondences are established, the legality 
of a lun parameter is specific to the task. which includes’ this 
parameter in a QIO request. In general, the lun must be in the 
following ranges 


0 <¢ lun ¢ length of task's LUT (if nonzero) 


The number of LUNs specified in the logical unit table of a particular 
task cannot exceed 255, 


The efn parameter is a number representing the event flag to be 
associated with the I/O operation. It may optionally be included in a 
QIO request. The event flag is cleared when the I/O request is queued 
and is set when the I/O operation has completed. This allows the task 
to use the WAITFOR system directive to synchronize I/O programming by 
suspending execution to wait for an I/O operation to complete and efn 
to be set; however, if the task continues to execute, it may test the 
event flag whenever it chooses by using the READ ALL EVENT FLAGS 
system directive. If the user specifies an event flag number, this 
number must be in the range 1 through 64. If an event flag 
specification is not desired, efn can be omitted or can be_ supplied 
with a value of zero. Event flags 1 through 32 are local (specific to 
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the issuing task); event flags 33 through 64 are global (shared by 
all tasks in the system). Flags 25 through 32 and 57 through 64 are 
reserved for use by system software. Within these bounds, the user 
can specify event flags as desired to synchronize I/O completion and 
task execution. Section 1.4.2 provides a more detailed explanation of 
event flags and significant events. 


The optional pri parameter is supplied only to make RSX=-11M QIO 
requests compatible with RSX-l1l1D. A specific priority cannot be 
associated solely with the I/O request specified in the QIO macro 
call. An RSX-11M I/O request automatically assumes the priority of 
the requesting task. For consistency with RSX-11D, it is recommended 
that pri be valid, but the user should be aware that RSX-11M does not 
use this specification in any way. RSX-11D priorities must be in 
range 1 through 250, and zero can be supplied to indicate the priority 
of the requesting task. A value of zero or a null specification is 
recommended for all RSX-11M use, 


The optional isb parameter identifies the address of the I/O status 
block (I/O status double-word) associated with the I/O request. This 
block is a 2-word array in which a code representing the final status 
of the I/0 request is returned on completion of the operation. This 
code is a binary value that corresponds to a symbolic name of the form 
IS.xxx (for successful returns) or IE.xxx (for error returns). The 
binary error code is returned to the low-order byte of the first word 
of the status block. It can be tested symbolically, by name. For 
example, the symbolic status IE.BAD is returned if a bad parameter is 
encountered, The following illustrates the examination of the I/0 
status block, IOST, to determine if a bad parameter has been detected. 


QIOSC IO.ATT,14.,2,,I10ST,...- 
WTSESC 2 


CMPB #TE.BAD,IOST 
BEQ ERROR 


The correspondence between global symbolic names and I/O completion 
codes is defined in the system object module library. Local symbolic 
definitions, which are summarized in Appendix B, may also be obtained 
via the IOERR$ macro which resides in the System Macro Library. 


Certain device-dependent information is returned to he high-order 
byte of the first word of isb on completion of the I/O operation. If 
a read or write operation is successful, the second word is also 
significant. For example, in the case of a read funet.ion on a 
terminal, the number of bytes typed before a carriage return is 
returned in the second word of isb. If a Magtape unit is the device 
and a write function is specified, this number represents the number 
of bytes actually transferred. The status block can be omitted from a 
QIO request if the user does not intend to test for successful 
completion of the request, 
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The optional ast parameter specifies the address of a service routine 
to be entered when an asynchronous system trap occurs. Section 1.4.3 
discusses the use of asynchronous system traps, and section 2.2.5 of 
the RSX-1L1M Executive Reference Manual describes traps in detail. If 
the user wants to interrupt his task to execute special code on 
completion of an I/O request, an asynchronous system trap routine can 
be specified in the QIO request. When the specified I/O operation 
completes, control branches to this routine at the software priority 
of the requesting task. The asynchronous code beginning at address 
ast is then executed, much as an interrupt service routine would be, 
If the user does not want to perform asynchronous processing, the ast 
parameter can be omitted or a value of zero specified in the QIO macro 
call. 


The additional QIO parameters, <pl,p2,...,p6>, are dependent on the 
particular function and device specified in the I/O request. Between 
zero and six parameters can be included, depending on the particular 
I/O function. Rules for including these parameters and legal values 
are described in subsequent chapters of this manual. 


1.4.2 Significant Events 


"Significant event" is a term used in real-time systems to indicate a 
change in system status. In RSX-11M, a significant event is declared 
when an I/O operation completes. This signals the system tht a 
change in status has occurred and indicates that the Executive should 
review the eligibility of all tasks in the system to determine which 
task should run next. The use of significant events helps cooperating 
tasks in a real-time system to communicate with each other and thus 
allows these tasks to control their own sequence of execution 
dynamically. 


Significant events are normally set by system directives, either 
directly or indirectly, by completion of a specified. function. Event 
flags associated with tasks may be used to indicate which significant 
event has occurred. Of the 64 event flags available in RSX-11M, the 
flags numbered 1 through 32 are local to an individual task and are 
set or reset only as a result of that task's operation. The event 
flags numbered 33 through 64 are common to all tasks. Flags 25 
through 32 and 57 through 64 are reserved for RSX-11M system software 
use e 


An example of the use of significant events follows. A task issues a 
QIO directive with an efn parameter specified. A WAITFOR directive 
follows the QIO and specifies as an argument the same event flag 
number, The event flag is cleared when the I/O request is queued by 
the Executive, and the task is suspended when it executes the WAITFOR 
directive until the event flag is set and a significant event is 
deciared at the completion of the I/O request. The task resumes when 
the appropriate event flag is set, and execution resumes at the 
instruction following the WAITFOR directive. During the time that the 
task is suspended, tasks with priorities lower than that of the 
suspended task have a chance to run, thus increasing throughput in the 
sys*ein. 
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1.4.3 System Traps 


System traps are used to interrupt task execution and to cause a 
transfer of control to another memory location for special processing. 
Traps are handled by the RSX-11M Executive and are relevant only to 
the task in which they occur, To use a system trap, a task must 
contain a trap service routine which is automatically entered when the 
trap occurs. 


There are two types of system traps =< synchronous and asynchronous. 
Both are used to handle error or event conditions, but the two traps 
differ in their relation to the task which is running when they are 
detected. Synchronous traps signal error conditions within the 
executing task. If the same instruction sequence were repeated, the 
same synchronous trap would occur. Asynchronous traps signal the 
completion of an external event such as an I/O operation. An 
asynchronous system trap (AST) usually occurs as the result of the 
initiation or completion of an external event rather than a program 
condition. 


The Executive queues ASTs in a first-in-first-out queue for each task 
and monitors all asynchronous’ service routine operations. Because 


asynchronous traps are the end result of JI/O-related activity, they 


cannot be controlled directly by the task. which receives them, 
However, the task may, under certain circumstances, block honoring an 
AST to prevent simultaneous access to a critical data region. When 
access to the critical data region has been completed, the queued ASTs 
may again be honored. The DSAR$S (DISABLE AST RECOGNITION) and ENARSS 
(ENABLE AST RECOGNITION) system directives provide the mechanism for 
accomplishing this. An example of an asynchronous trap condition is 
the completion of an I/O request. The timing of such an operation 
clearly cannot be predicted by the requesting task. If an AST service 
routine is not specified in an I/O request, a trap does not occur and 
normal task execution continues. 


Asynchronous system traps associated with I/O requests enable the 
requesting task to be truly event-driven. The AST.service routine 
contained in the initiating task is executed as soon as possible, 
consistent with the system's priority structure. The use of the AST 
routine to service I/O related events provides a response time which 
is considerably better than a polling mechanism, and provides for 
better overlap processing than the simple QIO and WAITFOR sequence, 
Asvnehronous system traps also provide an ideal mechanism for use in 
multiple buffering of I/O operations. 


All AST's are inserted in a first-in-first-out queue on a per task 
basis as they occur (i.e., the event which they are to -signal has 
expired). They are effected one at a time whenever the task does not 
have AST's disabled and is not already in the process of executing an 
AST service routine. The process of effecting an AST involves storing 
certain information on the task's stack, including the task's four 
WAITFOR mask words, the Directive Status Word (DSW), the PS, the PC 
and any .trap dependent parameters. The task's general-purpose 
registers RO-R5 are not saved and thus it is the responsibility of the 
AST service routine to save and restore the registers it uses. After 
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an AST is processed, the trap-dependent parameters (if any) must be 
removed from the task's stack and an AST SERVICE EXIT directive 
executed. The ASTX$S macro described in section 1.6.6 of this manual 
is used to issue the AST SERVICE EXIT directive. On AST service exit, 
control is returned to another queued AST, the executing task, or 
-another task which has been waiting to run. Section 2.2.5 of the 
RSX-11M Executive Reference Manual describes in detail the purpose of 
AST service routines and all system directives used to handle them. 


1.5 DIRECTIVE PARAMETER BLOCKS 


A directive parameter block (DPB) is a fixed-length area of contiguous 
memory which contains the arguments specified in a system directive 
macro call. The DPB for a QIO directive has a length of 12 words. It 
is generated as the result of the expansion of a QIO macro call. The 
first byte of the DPB contains the directive identification code (DIC) 
- always 1 for QIO. The second byte contains the size of the 
directive parameter block in words = always 12 for QIo. During 
assembly of a user task containing QIO requests, the MACRO-11 
Assembler generates a directive parameter block for each I/O request 
specified in a QIO macro call. At run time, the Executive uses the 
arguments stored in each DPB to create, for each request, an I/O 
packet in system dynamic storage. The packet is entered by priority 
into a queue of I/O requests for the specified physical device unit. 
This queue is created and maintained by the RSX-11M Executive and is 
ordered by the priority of the tasks which issued the requests. The 
I/O drivers examine their respective queues for the I/O request with 
the highest priority capable of being executed. This request is 
de-queued (removed from the queue) and the I/O operation is performed. 
The process is then repeated until the queue is emptied of all 
requests. 


After the I/O request has been completed, the Executive declares a 
significant event and may set an event flag, cause a branch to an 
asynchronous system trap service routine, and/or return the I/O 
status, depending on the arguments specified in the original QIO macro 
call. Figure 1-2 illustrates the layout of a sample DPB. 
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Word 0 size of DPB + il 


2 ey, «+ logical unit number 


0 Byte 


+ DIC for QIO 
directive 


modifiers| « I/O function 


3 priority > «+ event flag number 


4 « address of I/O 
status block 

5 <« address of 
asynchronous trap 
service routine. 

6 device- 

. dependent 

e parameters 

11 


Figure 1-2 
QIO Directive Parameter Block 


1.6 I/O-RELATED MACROS 


There are several system macros supplied with the RSX-11M system which 


are used to issue and return information about I/O requests. These 
macros reside in the System Macro Library and must be made available 
during assembly via the MACRO=-11 assembler directive .MCALL. 


There are three distinct forms of most of the system directive macros 
discussed in this section. The following list summarizes the forms of 
QIO$, but the characteristics of each form also apply to ALUNS$, GLUNS, 
and other system directive macros described below. 


1. QIO$ generates a directive parameter block for the I/O 
request at assembly time, but does not provide the 
instructions necessary to execute the request. This form of 
the request is actually executed using the DIRS macro. 


2. QIOSS generates a directive parameter block for the [1/0 
request on the stack, and also generates code to execute the 
request. This is a useful form for reentrant, sharable code 
Since the DPB is generated dynamically at execution time. 
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3. QIO$C generates a directive parameter block for the I/0O 
request at assembly time, and also generates code to execute 
the request. The DPB is generated in a separate program 
section called S$DPBSS,. This approach incurs little system 
overhead and is useful when an I/O request is executed from 
only one place in the program, 


Parameters for both the QIOS$ and QIOSC forms of the macro must be 
valid. expressions to be used in assembler data-generating directives 
such as .WORD and .BYTE. Parameters for the QIO$S form must be valid 
source operand address expressions to be used in assembler 
instructions such as MOV and MOVB. The following example references 
the same parameters in the three distinct forms of the macro call. 


QIO$ IO.RLB,6,2,,,ASTO1,... 

QIOSC . IO.RLB,6,2,,,AST0l,.e- 

QIoss #IO.RLB,#6,#2,,,#ASTOl,.o.~ 
Only the QIOS$S form of the macro produces the DPB dynamically. The 
other two forms generate the DPB at assembly time. The 


characteristics and use of these different forms are described in 
greater detail in the RSX-11M Executive Reference Manual. 


The following Executive directives and assembler macros are described 
in this section: | 


1. QIO$, which is used to request an I/O operation and _ supply 
parameters for that request. 


2. DIR$, which specifies the address of a directive parameter 
block as its argument, and generates code to execute the 
directive. 


3. »MCALL, which is used to make available from the System Macro 


Library all macros referenced during task assembly. 


4. ALUNS, which is used to associate a logical unit number with 
a physical device unit at run time. 


5. GLUN$, which requests that the information about a physical 
device unit associated with a specified LUN be returned to a 
user-specified buffer. 


6. ASTXSS, which is used to terminate execution of an 
asynchronous system trap (AST) service routine. 


7. WTSES, which instructs the system to suspend execution of the 
issuing task until a specified event flag is set. 
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1.6.1 The QIO$ Macros: Issuing an I/O Request 


As described in section 1.6, there are three distinct forms of the 
QIO$ macro. QIO$S generates a DPB for the I/O request on the stack, 
and also generates code to execute the request. QIO$C generates a DPB 
and code, but the DPB is generated in a separate program section. 
QIO$ generates only the DPB for the I/O request. This form of the 
macro call is used in conjunction with DIR$ (see section 1.6.2) to 
execute an I/O request. In the following example, the DIR$ macro 
actually generates the code to execute the QIO$ directive. It 
provides no QIO parameters of its own, but references the QIO 
directive parameter block at address QIOREF by supplying this label as 
an argument. 


QIOREF: QIO$ IO.RLB,6,2,,,ASTO], oe. ; CREATE QIO DPB 
READ]: DIRS #QIOREF ; ISSUE I/O REQUEST 
READ2: DIRS #QIOREF ; ISSUE I/O REQUEST 


1.6.2 The DIR$ Macro: Executing a Directive 


The DIR$ (execute directive) macro has been implemented to allow a 
task to reference a previously defined directive parameter block 
without requiring that it specify all of the parameters of that macro 
again. It is issued in the form: 


-DIRS ladér} [,err] 


where: addr is the address of a directive parameter block to be 
used in the directive. If addr is not included, the 
DPB itself or the address of the DPB is assumed to 
already be on the stack. 


err is an optional argument which specifies the address of 
an error routine to which control branches if the 
directive is rejected. The branch occurs via a JSR PC, 
err. 


1.6.3 The .MCALL Directive: Retrieving System Macros 


»MCALL is a MACRO-11 assembler directive which is used to retrieve 
macros from the System Macro Library (SY:[1,1]RSXMAC.SML) for use 
during assembly. It must be included in every user task which invokes 
system macros. eMCALL is usually placed at the beginning of a user 
task and specifies, as arguments in the call, all system macros which 
must be made available from the library. 
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The following example illustrates the use of this directive: 


eMCALL QIO$,QIO$S,DIRS$,WTSESS + MAKE MACROS AVAILABLE 


QIOREF: QIOS IO.RLB,6,2,,,AST0O1, . . «7 CREATE ONLY QIO DPB 


READ]: DIRS$ #QIOREF ; ISSUE I/O REQUEST 


READ2: QIOSS #10. ATT, #14. ,#8.,,,#ASTO2 _3 CREATE DPB ON STACK 
: AND ISSUE REQUEST 


As many macro references as can fit on a line can be included in a 


single .MCALL directive. There is no limit to the number of .MCALL 


directives that can be specified. 


1.6.4 The ALUNS$S Macro: Assigning a LUN 


The ASSIGN LUN macro is used to associate a logical unit number with a 
physical device unit at run time. All three forms of the macro call 
may be used. ASSIGN LUN does not request I/O for the physical device 
unit, nor does it attach the unit for exclusive use by the issuing 
task. It simply establishes a LUN=physical device unit relationship, 
so that when the task requests I/O for that particular LUN, the 
associated nhvsical device unit is referenced. The macro is issued 
from a MACRO-11 program in the following way: 


ALUNS lun ,dev,unt 
where: lun is the logical unit number to be associated with the 
specified physical device unit. 
dev is the device name of the physical device. 
unt is the unit number of that physical device. 


For example, to associate LUN 10 with terminal unit 2, the following 
macro call could be issued by the task: 


ALUNSC 10.,TT,2 
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A unit number of 0 represents unit 0 for multi-unit devices such as 
disk, DECtape, or terminals; it indicates the single available unit 
for devices without multiple units, such as card readers and line 
printers. 


The following list contains device names, listed alphabetically, that 
may be included as dev parameters for all standard devices supported 


by RSX-11M,. 


Name Device 

AD ADO1=-D Analog=-to-Digital Converter 

AF AFCl11 Analog-to~Digital Converter 

CR CR11 Card Reader 

CT TA1L1 Tape Cassette 

DB RJPO04 Pack Disk 

DF RF11/RS1l Fixed=-Head Disk 

DK RK11/RK05 Cartridge Disk 

DP RP11-C/RP03 Pack Disk 

DS RJSO3 and RJS04 Fixed-Head Disks 

DT TC11-G DECtape 

LP LP11, LS11, and LV1l Line Printers 

LS LPS11 Laboratory Peripheral System 

MM TJU16 Magnetic Tape. 

MT TM11/TU10 Magnetic Tape 

TT Terminals 

UD UDC11l Universal Digital Controller 

XL DL11-E Asynchronous Communication Line Interface 
XP DP11 Synchronous Communication Line Interface 
XU DU11 Synchronous Communication Line Interface 


A pseudo-device is a logical device which can normally be redirected 
by the operator to another physical device unit at any time, without 
requiring changes in programs which reference the pseudo-device. 
Dynamic redirection of a physical device unit affects all tasks in the 
system; reassignment by means of the MCR REASSIGN command affects 
only one task. The following pseudo-devices are supported by RSX=-11M: 
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Code Device 

CL Console listing, normally the line printer 

co Console output, normally the main operator's console 

TI Pseudo-input terminal, normally the terminal from which 


a task was requested 


SY System default device, normally the disk from which the 
system was bootstrapped 


The pseudo-device TI cannot be redirected, since such redirection 
would have to be handled on a per task rather than a system wide basis 
(i.e., change the TI device for one task without affecting the TI 
assignments for other tasks). . 


The example included below illustrates the use of the three forms of 
the ALUNS macro, 


DATA DEFINITIONS 


=e se 


ASSIGN: ALUNS 10.,TT,2 ; GENERATE DPB 


EXECUTABLE SECTION 


=e se SO 


DIR$ #ASSIGN : EXECUTE DIRECTIVE 


ALUNSC 10.,TT,2 ; GENERATE DPB IN SEPARATE PROGRAM 
° ; SECTION, THEN GENERATE CODE TO 
. 3 EXECUTE THE DIRECTIVE 


e 


ALUNSS #10.,#"TT,#2 GENERATE DPB ON STACK, THEN 


; 
+ EXECUTE DIRECTIVE 


1.6.5 The GLUNS Macro: Retrieving LUN Information 


The GET LUN. INFORMATION macro requests that information about a 
LUN=physical device unit association be returned in a 6-word buffer 
specified by the issuing task. All three forms of the macro call may 
be used. It is issued from a MACRO-11 program in the following way: 
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GLUN$ 1un,buf 
where: lun is the logical unit number associated with the physical 
device unit for which information is requested. 
buf is the 6-word buffer to which information is returned, 
For example, to request information on the disk unit associated with 
LUN 8, the following call is issued: . 


GLUN$C 8. ,IOBUF 


The 6-word buffer contains the following indicators on completion of 
the directive: 
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Word Byte Bit 


0 
1 0 
1 
2 0 
1 
2 
3 
4 
5 
6-12 
13 
14 
15 
3 
4 
5 


Contents 
Name of device associated with lun 
Unit number of associated device 
Driver flag value, indicating that the driver 
is resident (always returned as 128 (200 


octal) in RSX-11M) 


Unit record-oriented device (Q.de, card 
reader, line printer) (1 = yes) 


Carriage~-control device (e.g., line printer, 
terminal) (1 = yes) 


Terminal device (1 = yes) 


Directory device (Gedo, DECtape, disk) 
(1 = yes) 


Single directory device (1 = yes) 

Sequential device (1 = yes) 

Reserved 

Device mountable as a communications channel 
for Digital network support (e.g., DP11l, DU11) 
(1 = yes) 


Device mountable as a FILES-ll device (e.g., 
disk) (1 = yes) 


Device mountable (logical OR of bits 13 and 
14) (1 = yes) 


Undefined (included for RSX=-11D compatibility) 
Undefined (included for RSX=-11D compatibility) 


Default buffer size for device (e.g., length 
of line for terminal) 


The example included below illustrates the use of the three forms of 


the GLUNS macro, 
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DATA DEFINITIONS 


=e me MO 


GETLUN: GLUNS 6, DSKBUF + GENERATE DPB 


EXECUTABLE SECTION 


™e tO NS 


DIRS$ #GETLUN + EXECUTE DIRECTIVE 


GLUNS$C 6,DSKBUF 3; GENERATE DPB IN SEPARATE PROGRAM 
° + SECTION, THEN GENERATE CODE TO 
3 EXECUTE THE DIRECTIVE 


GLUN$S #6,#DSKBUF GENERATE DPB ON STACK, THEN 


; 
+ EXECUTE DIRECTIVE 


1.6.6 The ASTX$S Macro: Terminating AST Service 


The AST SERVICE EXIT macro is used to terminate execution of an 
asynchronous system trap (AST) service routine. Only the ASTXSS form 
of this macro is provided; ASTX$ and ASTXSC are unsupported forms of 
the macro call. The macro is issued in the following way: 


ASTXSS [err] 


where: err is an optional argument which specifies the address of 
an error routine to which control branches if the 
directive is rejected, 


On completion of the operation specified in this macro call, if 
another AST is queued and asynchronous system traps have not been 
disabled, then the next AST is immediately entered, Otherwise, the 
task's state before the AST was entered is restored (it is the AST 
service routine's responsibility to save and restore the registers it 
uses). 


1.6.7 The WISES$ Macro: Waiting for an Event Flag 
The WAIT FOR SINGLE EVENT FLAG macro instructs the system to suspend 
execution of the issuing task until the event flag specified in the 
macro call is set. This macro is extremely useful in synchronizing 
activity on completion of an I/O operation. All three forms of the 
macro call may be used. It is issued as follows: 

WTSES efn 


where: efn is the event flag number 
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WTSES causes the task to be suspended until the specified event flag 
is set. Frequently, an efn parameter is also included in a QIO$ macro 
call, and the event flag is set on completion of the I/O operation 
specified in that call. The following example illustrates task 
suspension pending setting of the specified event flag. This example 
also illustrates the use of the three forms of the macro call. 


DATA DEFINITIONS 


=e =e ~O 


GENERATE DPB 
I/O STATUS BLOCK 


WAIT: WISES 5 
IOSB: eBLKW 2 


=e @e 


EXECUTABLE SECTION 


=e te we 


ASSIGN LUN 14 TO MAGTAPE UNIT ZERO 
ATTACH DEVICE 

EXECUTE DIRECTIVE 

WAIT FOR EVENT FLAG 5 TO BE SET 


ALUNSS #14.,#"MM 
QIo$sc I0.ATT,14.,5 
DIRS #WALT : 
WISESC 5 


=e =e MO NO 


QIoss #IO.RLB,#14.,#2,,#IOSB, #ASTX, <#BUF, #80. > 
. : READ RECORD 


WTSESS #2 ; WAIT FOR EVENT FLAG 2 


QIOSC I0.WLB,14.,3,,10SB,AST01,<BUF,80.> 


° . 3 WRITE RECORD 
WTSESC 3 ; WAIT FOR WRITE TO COMPLETE 
QIO$c IO.DET,14. ; DETACH DEVICE 


1.7 STANDARD I/O FUNCTIONS 


There are a large number of input/output. operations that can be 
specified by means of the QIO macro. A particular operation can be 
requested by including the appropriate function code as the first 
parameter of a QIO macro call. Certain functions are standard. These 
functions are almost totally device-independent and can thus be 
requested for nearly every device described in this manual, Others 
are device-dependent and are specific to the operation of only one or 
two I/O devices. This section summarizes the function codes and 
characteristics of the following device-independent I/O operations: 


e attach to an I/O device 
e detach from an I/O device 


e cancel I/O requests 
1-22 
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» read a logical block 
e read a virtual block 
e write a logical block 
e write a virtual block 


For certain physical device units discussed in this manual, a standard 
I/O function may be described as being a NOP. This means that no 
operation is performed as a result of specifying the function, and an 
I/O status code of IS.SUC is returned in the I/O status block 
specified in the QIO macro call. 


In the following descriptions and in formats shown in subsequent 
chapters, the five parameters represented by the ellipsis (...) are as 
explained in section 1.4.1. 


1.7.1 I0O.,ATT: Attaching to an I/O Device 


The function code IO.ATT is specified by a user task when that task 
requires exclusive use of an I/O device. This function code is 
included as the first parameter of a QIO macro call in the following 
way: 


QIOSC ITO.ATT pe oe 


Successful completion of an IO.ATT request causes the specified 
physical device unit to be dedicated for exclusive use by the issuing 
task. This enables the task to process input or output in an unbroken 
stream and is especially useful on sequential, non-file-oriented 
devices such as terminals, card readers, and line printers. An 
attached physical device unit remains under control of the issuing 
task until it is explicitly detached by that task. The same LUN must 
be specified for both the attach and detach functions. 


While a physical device unit is attached, the I/O driver for that unit 
dequeues only I/O requests issued by the task that issued the attach. 
Thus, a request to attach a device unit already attached by another 
task will not be processed until the attachment is broken and no 
higher priority request exists for the unit. A LUN that is associated 
with an attached physical device unit may not be reassigned by means 
of an ASSIGN LUN directive. 


T£ the task which issued an attach function exits or is aborted before 


it issues a corresponding detach, the RSX-11M Executive automatically 
detaches the physical device unit. 
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1.7.2 IO.DET: Detaching from an I/O Device 


The function code IO.DET is used to detach a physical device unit 
which has been previously attached by means of an IO.ATT request for 
exclusive use of the issuing task. This function code is included as 
the first parameter of a QIO macro call in the following way: 


QIO$c IO.DET, «ee 


The LUN specifications of both IO.ATT and IO.DET must be the same, as 
in the following example, which also illustrates the use of "S" forms 
of several macro calls. 


eMCALL ALUNS$S,QIO$S 
ALUNSS #14.,#"CR + ASSOCIATE CARD READER WITH LUN 14 


QIoOss #IO.ATT, #14, ; ATTACH CARD READER 


LOOP: QIOSS #I0O.RLB,#14.,... ; READ CARD 


QIOSS #IO.DET, #14. ; DETACH CARD READER 


1.7.3  IO.KIL: Canceling I/O Requests 


The function code IO.KIL is issued by a task to cancel all of that 
task's I/O requests for a particular physical device unit, including 
all pending and active requests. This results in the status code 
IE.ABO being returned in the I/O status block and the event flag being 
set (if specified) for the respective requests, but does not initiate 
any asynchronous system trap (AST) service routine that may have been 
specified. Whether the current request is actually cancelled depends 
on the device. Because file-structured devices (disk and DECtape) 
operate quickly, IO.KIL is a NOP for these devices and simply causes 
the return of IS.SUC in the I/O status block. 


This function code is included as the first parameter of a QIO macro 
in the following way: 


QIO$C LO. KILyeee 


IO.KIL is useful in such special cases as canceling an I/O request on 
a physical device unit from which a response is overdue (i.e., a read 
on a terminal). 
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1.7.4 IO.RLB: Reading a Logical Block 


The function code IO.RLB is specified by a task to read a block of 
data from the physical device unit specified in the macro call. This 
function code is included as the first parameter of a QIO macro in the 
following ways 


QIOSCc IO. RLB,...,<stadd,size,pn> 


where: stadd is the starting address of the data buffer. 
size is the data buffer size in bytes. 


pn represents one to four optional parameters, used to 
specify such additional information as block numbers 
for certain devices, 


1.7.5 I0.RVB: Reading a Virtual Block 


The function code IO.RVB is used to read a virtual block of data from 
the physical device unit specified in the macro call. A "virtual" 
block indicates a relative block position within a file and is 
identical to a "logical" block for such sequential devices as 
texminals and card readers. It is recommended that all tasks’ use 
virtual rather. than logical reads. However, if a virtual read is 
issued for a file-structured device (disk or DECtape), the user must 
ensure that a file is open on the specified physical device unit. 
This function code is included as the first parameter of a QIO macro 
call in the following way: 


QIoO$Sc IO. RVB,...,<stadd,size,pn> 
where: stadd is the starting address of the data buffer. 
size is the data buffer size in bytes. 
ph represents one to four optional parameters, used to 


specifv such additional information as block numbers 
for certain devices, 


1.7.6 IO.WLB: Writing a Logical Block 
The function code IO.WLB is specified by a task to write a block of 
data to the physical device unit specified in the macro call, MThis 


function code is included as the first parameter of a O10 «acre cail 
in the following way: 


QIOSC IO.WLB,.0.,<stadd,size 7pn> 


where: stadd is the starting address of the Gata huffor,. 
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size is the data buffer in bytes. 


ph represents one to four optional parameters, used to 
specify such additional information as block numbers or 
format control characters for certain devices. 


1.7.7 IO.WVB: Writing a Virtual Block 


The function code IO.WVB is used to write a virtual block of data to a 
physical device unit. A "virtual" block indicates a relative block 
position within a file and is identical to a "logical" block for such 
sequential devices as terminals and line printers. It is recommended 
that all tasks use virtual rather than logical writes. However, if a 
virtual write is issued for a file-structured device (disk or 
DECtape), the user must ensure that a file is open on the specified 
physical device unit. This function code is included as the first 
parameter of a QIO macro call in the following way: 


QIOSC IO.WVB,...,<stadd,size,pn> 


where: stadd is the starting address of the data buffer. 
size is the data buffer size in bytes. 


pn represents one to four optional parameters, used to 
specify such additional information as block numbers or 
format control characters for certain devices. 


1.8 I/0 COMPLETION 


When an I/O request has been completed, either successfully or 
unsuccessfully, one or more actions may be taken by the Executive. 
Selection of return conditions depends on the parameters included in 
the QIO macro call. There are three major returns: 


1. A sianificant event is declared on completion of an I/0 
operation, If an efn parameter was included in the I/0 
request, the corresponding event flag is set. 


2. If an isb parameter was specified in the QIO macro call, a 
code identifying the type of success or failure is returned 
in the low-order byte of the first word of the I/O status 
block at the location represented by isb. 


This status return code is of the form IS.xxx (success) or 
IE.xXxx (error). For example, if the device accessed by the 
T/O request is not ready, a status code of IE.DNR is returned 
in ish, The section below (Return Codes) summarizes general 
coves ~eturned by most of the drivers described in this 
narntial,. ’ 
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If the isb parameter was omitted, the requesting task cannot 
determine whether the I/O request was successfully completed. 
A carry clear return from the directive itself simply means 
that the directive was accepted and the I/O request was 
queued, not that the actual input/output operation was 
successfully performed, 


3. If an ast parameter was specified in the QIO macro call, a 
branch to the asynchronous system trap (AST) service routine 
which begins at the location identified by ast occurs on 
completion of the I/O operation. See section 1.4.3 fora 
detailed description of AST service routines. 


1.9 RETURN CODES 


There are two kinds of status conditions recognized and handled by 
RSX-11M when they occur in I/O requests: 


. Directive conditions, which indicate the acceptance or 
rejection of the QIO directive itself 


- I/O status conditions, which indicate the success or failure 
of the I/O operation 


. 


Directive conditions relevant to I/O operations may indicate any of 


the following: 

» directive acceptance 

e invalid buffer specification 

- invalid efn parameter 

- invalid lun parameter 

e invalid DIC number or DPB size 

e unassigned I.UN 

» insufficient memory 
A code indicating the accentance or rejection of a directive is 
returned to the directive status word at symbolic location S$DSW, This 
location can be tested to determine the type of directive condition. 
I/O conditions indicate the success or failure of the I/O operation 
specified in the QIO directive. I/O dariver errors incluile such 
conditions as device not ready, privilege violation, file already 
open, or write-locked device, If an isb parameter is included in tre 
QIO directive, identifying the address of a 2-word T/O status block, 
an I/O status code is returned in the lowecrder byte of the first word 


of this block on completion of the I/O operation, This cole ais a 
binary value which corresponds to a symbolic name of the form T5,xxx 
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or IE.xxx. The low-order byte of the word can be tested symbolically, 
by name, to determine the type of status return. The correspondence 
between global symbolic names and directive and I/O completion status 
codes is defined in the system object module library. Local symbolic 
definitions may also be obtained via the DRERRS and IOERR$ macros 
which reside in the System Macro Library and are summarized in 
Appendix B. 


Binary values of status codes always have the following meaning: 


Code Meaning 

Positive (greater than zero) Successful completion 
Zero Operation still pending 
Negative Unsuccessful completion 


A pending operation means that the I/O request is still in the queue 
of requests for the respective driver, and the driver has not yet 
serviced the request. 


1.9.1 Directive Conditions 


Table 1-1 summarizes the directive conditions which may be encountered 
in QIO directives. The acceptance condition is first, followed by 
error codes indicating various reasons for rejection, in alphabetical 
order. 
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Table l-1 
Directive Conditions 


Reason 
Directive accepted 


The first six parameters of the QIO directive were 
valid, and sufficient dynamic memory was available to 
allocate an I/O packet. The directive is accepted. 


Invalid address 


The I/O status block or the QIO DPB was outside of the 
issuing task's address space or was not aligned on a 
word boundary. 


Invalid event flag number 


The efn specification in a QIO directive was less’ than 
zero or greater than 64. 


Invalid logical unit number 


The lun specification in a QIO directive was invalid 
for the issuing task. For example, there were only 
five logical unit numbers associated with the task, and 
the value specified for lun was greater than five. 


Invalid DIC number or DPB size 


The directive identification code (DIC) or the size of 
the directive parameter block (DPR) was incorrect; the 
legal range for a DIC is from 1 through 127, and all 
DIC values must be odd. Each individual directive 
requires a DPB of a certain size. If the size is not 
correct for the particular directive, this code is 
returned. 


Unassigned LUN 


The logical unit number in the QIO directive was not 
associated with a physical device unit. The user may 
recover from this error by issuing a valid ASSIGN LUN 
directive and then reissuing the rejected directive, 


Insufficient dynamic memorv 


There was not enough dynamic memory to allocate an I/0 
packet for the I/0 request. The user can try again 
later by suspending the task with a WAITFOR SIGNIFICANT 
EVENT directive. Note that WAITFOR SIGNIFICANT EVENT 
is the only effective way for the issuing task to 
suspend execution, since other suspend=-type directives 
that could be used for this purpose themselves require 
dynamic memory for their execution (e.g., MARK TIME). 
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1.9.2 I/0 Status Conditions 


The following list summarizes status codes which may be returned in 
the I/O status block specified in the QIO directive on completion of 
the I/O request. The I/O status block is a 2=word block with the 
following format: 


- The low-order byte of the first word receives a status code 
of the form IS.xxx or IE.xxx on completion of the I/O 
operation, 


- The high-order byte of the first word is usually 
device-dependent; in cases where the user might find 
information in this byte helpful, this manual identifies that 


information. 


The second word contains the number of bytes transferred or 
processed if the operation is successful and involves reading 
or writing. 


If the isb parameter of the QIO directive is omitted, this information 
is not returned, 


The following illustrates a sample 2-word I/O status block on 
completion of a terminal read operation: 


1 0 Byte 


where -10 is the status code for IE.EOF (end of file). If this code 
is returned, it indicates that input was terminated by typing CTRL/Z, 
which is the end-of-file termination sequence on a terminal. 


To test for a particular error condition, the user generally compares 
the low-order byte of the first word of the I/O status block with a 
symbolic value as in the following: 


CMPB #1E.DNR, IOSB 


However, to test for certain types of successful completion of the I/O 
operation, the entire word value must be compared. For example, if a 
carriage return terminated a line of input from the terminal, a 
successful completion code of IS.CR is returned in the I/O status 
block. If an ESCape or ALTMODE character was the terminator, a code 
of IS.ESC is returned. To check for either of these codes, the user 
should first test the low-order byte of the first word of the block 
for IS.SUC and then test the full word for IS.CR or IS.ESC. 


Note that all three of the following comparisons will test equal. since 
the low-order byte in all cases is +l. 
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CMPB #IS.CR,IOSB 
CMPB #IS.ESC,IOSB 
CMPB #IS.SUC,IOSB 
In the case of a successful completion where the carriage return is 


the terminal indicator (IS.CR), the following illustrates the status 
blocks: 


Byte 


1 Number of bytes read 


where 15 is the octal code for carriage return and +l is the _ status 
code for successful completion, 


The codes described in Table 1-2 are general status codes which apply 
to the majority of devices presented in subsequent chapters. Error 
codes specific to only one or two drivers are described only in 
relation to the devices for which they are returned. The list below 
describes successful and pending codes first, then error codes in 
alphabetical order. 


Table 1=2 
I/O Status Conditions 


Code Reason 
IS.SuCc Successful completion 


The I/O operation specified in the QIO directive was 
completed successfully. The second word of the I/0 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing. 


IS.PND I/O request pending 
The I/O operation specified in the QIO directive has 


not yet been executed. The I/O status block is filled 
with zeros. 
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Table 1-2 (Cont.) 
I/O Status Conditions 


Reason 
Operation aborted 


The specified I/O operation was cancelled via I0.KIL 
while in progress or while still in the I/O queue. 


File already open 


The task attempted to open a file on the. physical 
device unit associated with the specified LUN, but a 
file has already been opened by the issuing task on 
that LUN. 


Bad parameter 


An illegal specification was supplied for one or more 
of the device-dependent QIO parameters (words 6-11). 
For example, a bad channel number or gain code was 
specified in an analog-to-digital converter I/0 
operation. 


Illegal block number 


An illegal block number’ was specified for a 
file-structured physical device unit. This code is 
returned, for example, if block 4800 is specified for 
an RKO5 disk, on which legal block numbers extend from 
zero through 4799, 


Byte-aligned buffer specified. 


Byte alignment was specified for a buffer, but only 
word alignment is legal for the. physical device unit. 
For example, a disk function requiring word alignment 
was requested, but the buffer was aligned on a byte 
boundary. Alternately, the length of a buffer was not 
an appropriate multiple of bytes. For example, all 
RPO3 disk transfers must be an even multiple of four 
bytes. 


Device already attached 


The physical device unit specified in an IO.ATT 
function was already attached to the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task. 
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Table 1-2 (Cont.) 
I/O Status Conditions 


Reason 


Device not attached 


The physical device unit specified in an I0.DET 
function was not attached to the issuing task. This 
code has no bearing on the attachment status with 
respect to other tasks. 


Device not ready 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
This code is often returned as the result of an 
interrupt. timeout, that is, a "reasonable" amount of 
time has passed, and the physical device unit has not 
responded. 


End-of-file encountered 


An end-of—file mark, record, or control character was 
recognized on the input device. . 


Illegal function 


A function code was specified in an I/O request that 
was illegal for the specified physical device unit. 
This code is returned if the task attempts to execute 
an illegal function or if, for example, a read function 


-is requested on an output<only device, such as the line 


printer. 
File not open 


The task attempted to close a file on the physical 
device unit associated with the specified LUN, but no 
file was currently open on that LUN. 


Insufficient buffer space 


Dynamic storage space has been depleted, and there was 
insufficient buffer space available to allocate a 
secondary control block. For example, if a task 
attempts to open a file, buffer space for the window 
and file control block must be _ supplied by the 
Executive. This code is returned when there is not 
enough space for such an operation. 
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Table 1-2 (Cont.) 
I/O Status Conditions 


Reason 
Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Illegal read overlay request 


A read overlay was requested and the physical device 
unit specified in the QIO directive was not the 
physical device unit from which the task was installed. 
The read overlay function can only be executed on the 
physical device unit from which the task image 
containing the overlays was installed. 


Privilege violation 


The task which issued a request was not privileged to 
execute that request. For example, for the UDC1l and 
LPS11, a checkpointable task attempted to connect to 
interrupts or to execute a synchronous’ sampling 
function. 


Illegal address space 


The buffer requested for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately a byte count of zero was 
specified. 


Unrecoverable error 

After the system's standard number of retries have been 
attempted upon encountering an error, the operation 
still could not be completed. This code is returned in 
the case of parity, CRC, or similar errors. 


Write-locked device 


The task attempted to write on a write-locked physical 


device unit. 
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TERMINAL DRIVER 


2.1 INTRODUCTION 
The terminal driver provides support for a variety of terminal devices 


under RSX-11M. Table 2-1 summarizes the terminals supported, and 
subsequent sections describe these devices in greater detail. 


Table 2-1 
Standard Terminal Devices 


Model Column Width Character Set ’ Baud Range 


ASR-33/35 72 64 110 
KSR= 33/35 72 | 64 110 
LA30-P 80 | 64 300 
LA30-S 80 64 110-300 
LA36 80-132 64-96% 110-300 
RTO2 64 | 64 110-1200 
RTO2=C 64 «64 | 110-1200 
VTO5B 72 64 | | 110-2400 
VT50 72 64 110-300 


* The LA36 transmits a set of 64 characters, but can print a set of 
96. 
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Where appropriate terminals must be strapped to transmit only 
upper-case alphabetic characters, Input lines can be at most 80 
bytes, and longer input lines are truncated. The terminal driver 
supports the communication line interfaces summarized in Table 2-2, 
These interfaces are described in greater detail in section 2.7. 
Programming is identical for all. 


Table 2=-2 
Standard Communication Line Interfaces 


Model Type 


DH11 16-line multiplexer or 

DH11-DM11=-BB 16-line multiplexer with modem control 
DJ11 _ .16-line multiplexer 

DL11-A/B/C/D Single-line interfaces 


2.1.1 ASR=-33/35 Teletypes 


The ASR=33 and ASR=35 Teletypes are asynchronous hard=<copy terminals. 
No paper tape reader or punch capability is supported. 


2.1.2 KSR-33/35 Teletypes 


The KSR=-33 and KSR-35 Teletypes are asynchronous, hard-copy terminals. 


2.1.3 LA30 DECwriters 


The LA30 DECwriter is an asynchronous, hard-copy terminal that is 
Capable of producing an original and one copy. It is particularly 
appropriate for systems requiring large numbers of printer-terminals. 
The LA30-P is a parallel model and the LA30-S is a serial model. 


2.1.4 ULA36 DECwriter 


The LA36 DECwriter is a high-speed asynchronous terminal which 
produces hard copy and operates in serial mode. It has an impact 
printer capable of generating multipart and special preprinted forms. 
Both upper-case and lower-case characters can be printed. 
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2.1.5 RT02 Alphanumeric Display Terminal and RT02-C Badge Reader/ 
phanumeric Display Termina 


The RT02 is a compact alphanumeric display terminal designed for 
applications in which source data is primarily numeric. A shift key 
permits the entry of 30 discrete characters, including upper-case 
alphabetic characters. The RTO2 can, however, receive and display 64 
characters. 


The RT02-C model also contains a badge reader. This feature provides 
a reliable method of identifying and controlling access to the PDP-11l 
or to a secure facility. Furthermore, data in a format corresponding 
to that of a badge (22-column fixed data) can be entered very quickly. 


21.6 VTO5B Alphanumeric Display Terminal 


The VTO05B is an alphanumeric display terminal that consists of a CRT 
display and a= self-contained. keyboard. From a programming point of 
view, it is equivalent to other terminals, except that the VT05B 
offers direct cursor addressing. 


2.1.7 VT50 Alphanumeric Display Terminal 


The VT50 is an alphanumeric display terminal that consists of a CRT 
display and a keyboard. It is similar to the VTO5B in capacity and 
operation, but is restricted under RSX-11M to a lower maximum baud 
rate and does not offer direct cursor addressing. 


2.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION’ system 
directive (the first characteristics word) contains the following 
information for terminals. A setting of 1 indicates that the 
described characteristic is true for terminals. 
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Bit 


Nu fF oO 


15 


Words 3 and 4 


Setting 


1 


1 
1 
0 
0 


oO 


are undefined; 


Meaning 
Record-oriented device 
Carriage-control device 
Terminal device 
Directory device 
Single-directory device 
Sequential device 
Reserved 


Device mountable as a communications 
channel 


Device mountable as a FILES=-1l volume 


Device mountable 


word 5 indicates the default buffer 


size for the device, for terminals the width of the terminal carriage 
or display screen. 
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2e3 QIO MACRO 
Table 2~3 lists the standard functions of the QIO macro that are 
valid for terminals. 


Table 2-3 
Standard QIO Functions for Terminals 


Format Function 
QIOSC IO.ATT,... Attach device 
QIOSC IO.DET,... Detach device 
QIOSC IO.KIL,... Cancel I/O requests 
QIOSC IO.RLB,...,<stadd,size> Read logical block 


(Read typed input into buffer) 


QLIOSC IO. RVB,...,<stadd,size> Read virtual block 


(Read typed input into buffer) 


QIOSC IO.WLB,...,<stadd,size,vfc> Write logical block 
(Print buffer contents) 


QTOSC IO.WVB,...,<stadd,size,vfc> Write virtual block 
(Print buffer contents) 


where: stadd is the starting address of the data buffer (may be on a 
byte boundary). 


size is the data buffer size in bytes (must be greater than 
Zero) . 


vic is a vertical format control character from Table 2<7, 


The effect of IO.KIL on an in progress request depends upon whether 
the request is for input or output. If it is for input (i.e., I0.RLB 


or IO.RVB), the request is forced to terminate, IE.ABO is returned, 


and the second word of the I/O status block contains the number of 
bytes already typed. If the request is for output (i.e., IO.WLB or 
IO.WVB), the transfer is terminated, and IS.SUC is returned. 


The terminal driver supports no device-specific functions. 
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2.4 STATUS RETURNS 


Table 2-4 lists error and status conditions that are returned by the 
terminal driver described in this chapter. 


Code 


IE .EOF 


IS.SUC 


IS.CR 


IS.ESC 


IS.PND 


IE .ABO 


IE.DAA 


Table 2-4 
Terminal Status Returns 


Reason 
Successful completion on a read with End-of-file 


The line of input read from the terminal was terminated 
with the end-of-file character CTRL/Z. 


Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing. 


Successful completion on a read 


The line of input read from the terminal was terminated 
by a carriage return, 


Successful completion on a read 


The line of input read from the terminal was terminated 
by an ESCape or ALTMODE character. 


I/O request pending 


The operation specified in the QIO directive has not 
yet been executed. The I/O status block if filled with 
Zeros. 


Operation aborted 


The specified I/O operation was cancelled via I0O.KIL 
while in progress or while in the I/O queue. 


Device already attached. 


The physical device unit specified in an IO.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task. 
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Code 


IE.DNA 


IE.DNR 


IE.IFC 


IE.NOD 


IE.OFL 


IE.SPC 


Table 2-4 (Cont.) 
Terminal Status Returns 


Reason 
Device not attached 


The physical device unit specified in an IO.DET 
function was not attached by the issuing task. This 
code has no bearing on the attachment status of other 
tasks. 


Device not ready 
The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 


This code is returned to indicate one of the following 
conditions: 


e A timeout occurred on the physical device 
unit (i.e., an interrupt was lost). 


- An attempt was made to perform a transfer on 
a remote DH11 line without carrier present. 


Illegal function 


A function code was specified in an I/O request that 
was illegal for terminals. 


Buffer allocation failure 


Dynamic storage has been depleted, and there was 
insufficient space available to allocate a buffer for 


an input request (i.e., all input is buffered ‘in the 


terminal driver). 
Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Illegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately, a byte count of zero was 
specified. 
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The following illustrates the contents of the I/O status block on 
return of an IS.ESC code: 


1 0 Byte 


Number of bytes read 


where 33 is the octal representation of the ESCape or ALTMODE 
character, and +l is the status code for successful completion 
(IS.SUC). The contents of this block on return of IS.CR are the same, 
except that the high-order byte of word 0 contains 15, the octal code 
for carriage return. Unlike other RSX-11M return codes, IS.CR and 
IS.ESC are word values, rather than byte values. The low-order byte 
simply indicates successful completion, and the high-order byte is 
required to show the specific type. To test for an IS.ESC or IS.CR 
code, the user can first: test the low-order byte of the first word of 
the I/O status block for IS.SUC, and then test the full word for 
IS.ESC or IS.CR. 


2.5 CONTROL CHARACTERS AND SPECIAL KEYS 


This section describes the particular meaning of special terminal 
control characters and keys for RSX~11M. 


2.5.1 Control Characters 


A control character is input from a terminal by holding the control 
key (CTRL) down while typing one other key. ‘Two of the control 
characters described in Table 2-5, CTRL/U and CTRL/Z, are echoed on 
the terminal printer as tU and tZ respectively. Other control 
characters are recognized by the terminal driver but are not printing 
characters and are therefore not echoed, 
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Character | 


CTRL/C 


CTRL/I 


CTRL/J 
CTRL/K 
CTRL/L 
CTRL/M 


CTRL/O 


CTRL/U 


CTRL/Z 


Table 2-5 
Terminal Control Characters 


Meaning 


Typing CTRL/C on the terminal causes unsolicited input 
on that terminal to be earmarked for the Monitor 
Console Routine (MCR). When the unsolicited input 
completes, it is passed to the MCR dispatcher. "MCR>" 
is echoed when the terminal is ready to accept the 
unsolicited input. 


Typing CTRL/I initiates a horizontal tab, and the 
terminal spaces to the next tab stop. Tabs are set at 
every eighth character position. 


Typing CTRL/J is equivalent to typing the LINE FEED key 
on the terminal. 


Typing CTRL/K initiates a vertical tab, and the 
terminal performs four line feeds. 


Typing CTRL/L initiates a form feed, and the terminal 
performs eight line feeds. Paging is not performed. 


Typing CTRL/M is equivalent to typing the carriage 
RETURN key on the terminal (See section 2.5.2). 


Typing CTRL/O suppresses output being sent to a 
terminal by the current I/O request. For attached 
terminals, CTRL/O remains in effect, and output 
continues to be suppressed until any of the following 
occur: ; 


- The terminal is detached 

- Solicited input is entered 

e Unsolicited input is entered 

- Another CTRL/O character is typed 


For unattached terminals, CTRL/O suppresses output for 
only the current output buffer. 


Typing CTRL/U before typing a line terminator causes 
previously typed characters to be deleted back to the 
beginning of the line, The system echoes this 
character as tU, followed by a carriage return and a 
line feed. This allows the line to be retyped. 


Typing CTRL/Z indicates an end-of-file for the current 
terminal input. It signals MAC, PIP, TKB, and other 
system tasks that terminal input is complete and the 
task should exit. The system echoes this character as 
tZ followed by a carriage return and a line feed. 
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2.5.2 Special Keys 


The ESCape, carriage RETURN, and RUBOUT keys have special significance 
for terminal input, as described in Table 2-6. A line can be 
terminated by an ESCape (or ALTMODE) character, by a carriage RETURN, 
by CTRL/Z, or by completely filling the input buffer (i.e., exhausting 
the byte count before a line terminator is typed). The standard 
buffer size for a terminal can be determined by issuing a GET LUN 
INFORMATION system directive and examining word 5 of the information 
buffer. 


Table 2-6 
Special Terminal Keys 


Key Meaning 


ESC Typing ESCape or ALTMODE signals the terminal driver 
that there is no further input on the current line. 
This line terminator allows further input on the same 
line since the carriage or cursor is not returned to 
the first column position. 


RETURN Typing RETURN terminates the current line and causes 
the carriage or cursor to return to the first column on 
the line. 

RUBOUT Typing RUBOUT deletes the last character typed on an 


input line. Only characters typed since the last line 
terminator may be deleted. Several characters can be 
deleted in sequence by typing successive RUBOUTs. The 
first RUBOUT echoes as a backslash (\), followed by the 
character which has been deleted. Subsequent RUBOUTs 
cause only the deleted character to be _ echoed. The 
next character typed which is not a RUBOUT causes 
another \ followed by the new character to be echoed. 
The following example illustrates rubbing out ABC and 
then typing CBA: 


ABC\CBA\CBA 
The second backslash is not displayed if a line 
terminator is typed after rubbing out the characters on 
a line, as in the following: 


ABC\CBA 


2.6 VERTICAL FORMAT CONTROL 


Table 2-7 below summarizes the meanings of all characters used for 
vertical format control on the terminal. Any one of these characters 
can be specified as the value of the vfc parameter in an I0O.WLB or 
IO.WVB function. 


223n 


ii: | ih] | sain ith ati | 5 fk enced cae ae eee FRESE FRASER ESE oR NEE ERLE LIE OBEN ES ROE RYE IDOE EOC EARP 


SSIS AEE FOR RET 


PETRIE 


AE FEET ELE 


EE RATT 


SESS RES 


SSE TREN 


ARI RE DENTE PRET LEE EE RE ROE EE US SERRE SE REISS ISSN 


a Ren omaR cara cI 


Paneia 
f * 


aon 
i 4 


CHAPTER 2. TERMINAL DRIVER 


Table 2-7 
Vertical Format Control Characters 


Octal 

Value Character Meaning 

040 blank SINGLE SPACE = Output a line feed, print the 
contents of the buffer, and output a carriage 
return. Normally, printing immediately follows 
the previously printed line. 

060 zero DOUBLE SPACE = Output two line feeds, print the 
contents of the buffer, and output a carriage 
return. Normally, the buffer contents are printed 
two lines below the previously printed line. 

061 one PAGE EJECT — Output eight line feeds, print the 
contents of the buffer, and output a carriage 
return, 

053 plus OVERPRINT =- Print the contents of the buffer and 
output a carriage return, normally overprinting 
the previous line. 

044 dollar PROMPTING OUTPUT - Output a line feed and print 

sign the contents of the buffer. This mode of output 
is intended for use with a terminal where a 
prompting message is output and input is then read 
on the same line, 

000 null INTERNAL VERTICAL FORMAT —- The buffer contents are 


printed without addition of vertical format 
control characters. In this mode, more than one 
line of guaranteed contiguous output can be 
printed per I/O request. 


All other vertical format control characters are interpreted as blanks 
(octal 040). 


2.7 TERMINAL INTERFACES 


This section summarizes the characteristics of the three types of 
standard communication line interfaces supported by RSX=-11M. 


2.7.1 DH11 Asynchronous Serial Line Multiplexer 


The DH11l multiplexer interfaces up to 16 asynchronous serial 
communications lines for terminal use. As many as 16 DHlls can be 
interfaced to the PDP=-1l1, and the total capacity is therefore 256 
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lines. The DH11 supports programmable baud rates with no parity. The 
DM11-BB option may be included to provide modem control for dial-up 
lines. These lines must be interfaced via Bell 103 or equivalent 
modems. 


2.7.2 DJ1ll Asynchronous Serial Line Multiplexer 


The DJ1l multiplexer interfaces as many as 16 asynchronous’ serial 
lines to the PDP-11 for local terminal communications. As many as 16 
DJlls can be interfaced to the PDP-1l, and the total capacity is 
therefore 256 lines. The DJ1l1 does not provide a dial-up capability 
but supports jumper selectable baud rates. 


2.7.3 DL1l Asynchronous Serial Line Interface 


The DL11 supports a single asynchronous serial line and handles 
full-duplex communication between the PDP-11 and a terminal. There 
are 13 standard baud rates available to DL11 users (40-9600 baud). 
Four versions of the DL11 interface are supported by RSX=-11M for 
terminal use: DL11-A, DL11-B, DL11-C, and DLI11=D. The DL11-E is 
supported only for message-oriented communications and is described in 
Chapter 9. A total of 16 DL11 interfaces can be supported on a single 
system for terminal use. 


2.8 PROGRAMMING HINTS 


This section contains information on important considerations relevant 
to users of the terminal driver described in this chapter. 


2.8.1 Terminal Line Truncation 


If the number of characters to be printed exceeds the line length of 


the physical device unit, the terminal driver discards the excess. 


characters. The user can determine that this will happen by examining 
word 5 of the information buffer returned by the GET LUN INFORMATION 
system directive, 


2.8.2 ESCape Code Conversion 


An ESCape or ALTMODE character code of 33, 175, or 176 is converted 
internally to 33 before it is returned to the user on input. 


2% 8. 3 Rev ece Control Function 


When sanding a Bonteel character (e.g., vertical tab) to the RT02-C 
Badge Reader and Data Entry Terminal, the high-order bit (bit 7) of 
the byte must be set to one. This causes the terminal driver not to 
recognize the character. In the case of a vertical tab, 213 octal 
must be output rather than 13 octal. 
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DISK DRIVERS 


3.1 INTRODUCTION 
The RSX-11M disk drivers support the disks summarized in Table 3-1. 
Subsequent sections describe these devices in greater detail. 


Table 3-1 
Standard Disk Devices 


MODEL. RPM SURFACES CYLINDERS WORDS/ WORDS / 

7 TRACK DRIVE . 
RF11/RS11 1800 1 128 2048, 262,144, 
RIPO4 3600 19 411 5632. 43,980,288, 
RISO3 3600 1 64 4096, 262,144. 
RISO4 3600 1 64 8192, 524,288, 
RKL1/RKOS —-:1500 2. 200 3072. 1,228,800. 
RP11C/RPO3 2400 20 400 2560. 20,480,000. 


All of the disks described in this chapter are accessed in essentially 
the same manner. Up to eight disks of each type may be connected to 
their respective controllers. Disks and other file-structured media 
under RSX-11M are divided logically into a series of 256-word blocks. 


3.1.1 RF11/RS11 Fixed-Head Disk 


The RF11 controller/RS1l fixed=-head disk provides random-access bulk 
storage. It features fast track-switching time and a redundant set of 
timing tracks. The RF11/RS11 is unique because .the hardware can 
automatically perform a spiral read across disk platters. 
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3.1.2 RJP04 Pack Disk 


The RJPO4 (RH11 controller/RP04 pack disk) pack disk consists of 19 
data surfaces and a moving read/write head. It is similar to the 
RP11-C/RP03, but has twice the capacity. The RJP04 offers large 
capacity storage with rapid access time. 


3.1.3 RJSO3 Fixed-Head Disk 


The RJSO3 (RH11 controller/RSO03 fixed-head disk) is a fixed head disk 
which offers speed and efficiency. With 64 tracks per cylinder, the 
RJSO3 has a capacity of 262,144 words. 


3.1.4 RJS04 Fixed-Head Disk 


The RJSO4 (RH11 controller/RS04 fixed<head disk) is similar to the 
RJSO3 disk, and interfaces to the same controller but provides twice 
the number of words per track and twice the capacity. 


3.1.5 RKI1/RKO5 Cartridge Disk 


The RK11 controller/RKO5 DECpack cartridge disk is an economical 
storage system for medium—-volume, random<access storage. The 
removable disk cartridge offers the flexibility of large off-line 
capacity with rapid transfers of files between on- and off-line units 
without necessitating copying operations. 


3.1.6 RP11-C/RPO3 Pack Disk 


The RP11-C controller/RP03 pack disk consists of 20 data surfaces and 
a moving read/write head, Only an even number of words can be 
transferred in an RP03 read/write operation. 
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3.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 
directive (the first characteristics word) contains the following 
information for disks. A bit setting of 1 indicates that the 
described characteristic is true for disks. 


Bit Setting Meaning 
0 0 Record-oriented device 
1 0 Carriage-control device 
2 0 Terminal device 
3 1 Directory device 
4 0 Single-directory device 
5 0 Sequential device 
6-12 0 Reserved 
13 0 Device mountable as a communications 
channel 
14 1 Device mountable as a FILES=-11 volume 


ge 1 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates the 
default buffer size, which is 512 for all disks. 


3-3 QIO MACRO 


Table 3-2 lists the standard functions of the QIO macro that are valid 
for disks. 
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Table 3-2 
Standard QIo Functions for Disks 


Format . | Function 
QIO$C IO.ATT,...~ Not applicable (NOP) 
QIOS$SC IO.DET,... Not applicable (NOP) 
QIO$C IO.KIL,... | _ Not applicable (NOP) 


QIOSC IO.RLB,...,<stadd,size,,blkh,blk1> Read logical block 
QIOSC IO. RVB,...,<stadd,size, ,blkh.b1lkl1> Read virtual block 
QIOSC IO.WLB,...,<stadd,size, ,blkh,blkl> Write logical block 


QLOSC IO.WVB,...,<stadd,size,,blkh,blkl> Write virtual block 


where: stadd is the starting address of the data buffer (must be on 


a word boundary). 


size is the data buffer size in bytes (must be even, greater 
than zero, and, for the RP03, also a multiple of four 
bytes). 


blkh/b1kl are block high and block low, combining to form a 
double-precision number that indicates the 
logical/virtual block address on the disk where the 
transfer starts; blkh represents the high eight bits 

of the address, and blkl the low 16 bits. 


IO.RVB and IO.WVB are associated with file operations (see the RSX-11 
I/O Operations Reference Manual). For these functions to be executed, 
a file must be open on the specified LUN. 


The disk drivers support no device-specific functions. 


3.4 STATUS RETURNS 


The error and status conditions listed in Table 3-3 are returned by 
the disk drivers described in this chapter. 
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Code 


IS.SuUC 


IS.PND 


IE. ALN 


IE.BLK 
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Table 3=3 
Disk Status Returns 


Reason 


Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing. . “4 


I/O request pending 


The operation specified in the QIO directive has not 
yet been executed, The I/O status block is filled with 


Zeros. 


File already open 


The task attempted to open a file on the physical 
device unit associated with specified LUN, but a file 
has already been opened by the issuing task on that 
LUN. 


Illegal block number 


An illegal logical block number was specified, This 
code would be returned, for example, if block 4800 were 
specified for an RK05 disk, on which legal block 
numbers extend from zero through 4799. 


Byte~aligned buffer specified 


Byte alignment was specified for a buffer, but only 
word alignment is legal for disk. Alternately, the 
length of a buffer is not an appropriate number of 
bytes. For example, all RP03 disk transfer must be a 
multiple of four bytes, 


Device not ready 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
IE.IFC Illegal function 


A function code was specified in an I/O request that is 
illegal for disks. 
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Code 


IE.NLN 


TE.NOD 


ITE.OFL 
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Table. 3-3 (Cont.) 
Disk Status Returns 


Reason 


File not open 


The task attempted to close a file on the physical 
device unit associated with the specified LUN, but no 
file was currently open on that LUN. 


Insufficient buffer space 


Dynamic storage space has been depleted, and there was 
insufficient buffer space available to allocate a 
secondary control block. For example, if a task 
attempts to open a file, buffer space for the window 
and file control block must be _ supplied by the 
Executive. This code is returned when there is not 
enough space for this operation, 


Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Illegal read overlay request 


A read overlay was requested, and the physical device 
unit specified in the QIO directive was not the 
physical device unit from which the task was installed. 
The read overlay function can only be executed on the 
physical device unit from which the task image 
containing the overlays was installed. 


Privilege violation 


The task which issued the request was not privileged to 
execute that request. For disk, this code is returned 
if a nonprivileged task attempts to read or write a 
mounted volume directly (i.e., I0.RLB or IO.WLB). 
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Table 3-3 (Cont.) 
Disk Status Returns 


Code Reason 


IE.SPC Illegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately, a byte count of zero was 
specified. 


IE.VER Unrecoverable error 


After the system's standard number of retries has been 
attempted upon encountering an error, the operation 
still could not be completed. For disk, unrecoverable 
errors are usually parity errors. 


IE .WLK Write-locked device 


The task attempted to write on a disk that was 
physically write~locked, 


When a disk I/O error condition is detected, an error is usually not 
returned immediately. Instead, RSX-11M attempts to recover from most 
errors by retrying the function as many as eight times. Unrecoverable 
errors are generally parity, timing, or other errors caused by a 
hardware malfunction. 
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CHAPTER 4 


DECTAPE DRIVER 


4.1 INTRODUCTION 


The RSX-11M DECtape driver supports the TC11-G dual DECtape controller 
with up to three additional dual DECtape transports. The TCl1-G is a 
dual-unit, bidirectional, magnetic-tape transport system for auxiliary 
data storage. DECtape is formatted to store data at fixed positions 


on the tape, rather than at unknown or variable positions as_ on 


coventional magnetic tape. The system uses redundant recording of the 
mark, timing, and data tracks to increase reliability. Each reel 
contains 578 logical blocks. As with disk, each of these blocks can 
be accessed separately, and each contains 256 words. — i 


4,2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 


directive (the first characterics word) contains the following 


information for DECtapes. A bit setting of 1 indicates that the 
described characteristic is true for DECtapes. 
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i 
i 
i 
} 
i 
| 
Bit Setting Meaning 
0 0 Record-oriented device | 
i 
1 0 Carriage-control device 
2 0 Terminal device | 
3 1 Directory device | 
q 
4 0 Single-directory device 
i 
5 0 Sequential device | 
H 
6-12 0 Reserved ' 
13 0 Device mountable as a communications 
channel 

14 1 Device mountable as a FILES-11 volume 
gE 
15 1 Device mountable F 


ere aaeee eee 


Words 3 and 4 of the buffer are undefined; word 5 indicates the 
default buffer size, for DECtape 512 bytes. 
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4.3 QIO MACRO 


This section summarizes standard and device-specific QIO functions for 
the DECtape driver. 


ETE 


4.3.1 Standard QIO Functions 


Table 4-1 lists the standard functions of the QIO macro that are valid 
for DECtape. 
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Table 4-1 
Standard QIO Functions for DECtape 


Format Function 
QIO$C IO.ATT,... Not applicable (NOP) 
QIOSC IO0.DET,... | Not applicable (NOP) 
QIOSC IO.KIL,... Not applicable (NOP) 
QIO$C IO.RLB,...,<stadd,size,,,lbn> Read logical block (forward) 
QIOSC IO.RVB,...,<stadd,size,,,lbn> Read virtual block (forward) 
QIOSC IO.WLB,...,<stadd,size,,,lbn> Write logical block (forward) 
QIO$SC IO.WVB,...,<stadd,size,,,lbn> Write virtual block (forward) 


where: stadd is the starting address of the data buffer (must be on 
a word boundary). 


size is the data buffer size in bytes (must be even and 
greater than zero). 


lbn is the logical block number on the DECtape where the 
transfer starts (must be in the range 0-577). 


IO.RVB and IO.WVB are associated with file operations (see the RSX-11M 
I/O Operations Reference Manual). For these functions to be executed, 
a file must be open on the specified LUN, 
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4.3.2 Device-Specific QIO Functions 


The device-specific functions of the QIO macro that are valid for 
DECtape are shown in Table 4-2, 


Table 4-2 
Device-Specific Functions for DECtape 


Format Function . 
QIO$SC IO.RLV,...,<stadd,size,,,lbn> Read logical block (reverse) 
QIOSC IO.WLV,...,<stadd,size,,,lbn> Write logical block (reverse) 


Where: stadd is the starting address of the data buffer (must be on 
a word boundary). 


size is the data buffer size in byte (must be even and 
greater than zero). 


lbn is the logical block number on the DECtape where the 
transfer starts (must be in the range 0-577). 


4.4 STATUS RETURNS 


The error and status conditions listed in Table 4-3 are returned by 
the DECtape driver described in this chapter. 
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Code 


IS.SUC 


IS.PND 


IE.ALN 


IE.BLK 


IE.BYT 


IE.DNR 
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Table 4-3 
DECtape Status Returns 


Reason 
Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing. 


I/O request pending 

The operation specified in the QIO directive has not 
yet been executed, The I/O status block is filled with 
ZeXOS« 

File already open 

The task attempted to open a file on the physical 
device unit associated with specified LUN, put a file 
has already been opened by the issuing task on that 
LUN. 

Illegal block number, 


An illegal logical block number was specified for 
DECtape. The number exceeds 577 (1101 octal). 


Byte~aligned buffer specified. 

Byte alignment was specified for a buffer, but only 
word alignment is legal for DECtape. Alternately, the 
length of the buffer is not an even number of bytes. 


Device not ready 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
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Table 4-3 (Cont.) 
DECtape Status Returns 


Reason 


Illegal function 


A function code was specified in an a request that is 
illegal for DECtape. 


File not open 


The task attempted to close a file on the physical 
device unit associated with the specified LUN, but no 
file was currently open on that LUN. 


Insufficient buffer space 


Dynamic storage space has been depleted, and there was 
insufficient buffer space available to allocate a 
secondary control block. For example, if a task 
attempts to open a file, buffer space for the window 
and file control block must be supplied by the 
Executive. This code is returned when there is not 
enough space for this operation. 


Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Illegal read overlay request 


A read overlay was requested and the physical device 
unit specified in the QIO directive was not’ the 
physical device unit from which the task was installed. 
The read overlay function can only be executed on the 
physical device unit from which the task image 
containing the overlays was installed. 


Privilege violation 


The task which issued the request was not privileged to 
execute that request. For DECtape, this code is 
returned when a nonprivileged task attempts to read or 
write a mounted volume directly (i.e., IO.RLB, IO.RLV, 
IO.WLB, or IO.WLV). IE.SPC Illegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately, a byte count of zero was 
specified. 
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Table 4-3 (Cont.) 
DECtape Status Returns 


Code ; Reason 
IE.VER Unrecoverable error 


After the system's standard number of retries has been 
attempted upon encountering an error, the operation 
still could not be completed. For DECtape, this code 
is returned to indicate any of the following 
conditions. 


- A parity error was encountered. 


- The task attempted a forward multi-block transfer 
past block 577 (1101 octal). 


- The task attempted a backward multi-block transfer 
past block zero. 


IE.WLK Write-locked device 


The task attempted to write on a DECtape unit that was 
physically write-locked. 


4.4.1 DECtape Recovery Procedures 


When a DECtape I/O error condition is detected, RSX-11M attempts to 
recover from the condition by retrying the function as many. as five 
times. Unrecoverable errors are generally parity, mark track, or 
other errors caused by a faulty recording medium or a hardware 
malfunction. An unrecoverable error condition also occurs when a read 
or write operation is performed past the last block of the DECtape on 
a forward operation, or the first block of the DECtape on ae reverse 
operation. 


In addition to the standard error conditions, an unrecoverable error 
is reported when the "rock count" exceeds eight. The rock count is 
the number of times the DECtape driver reverses the direction of the 
tape while looking for a block number. Assume that the block numbers 
on a portion of DECtape are 98, 96, and 101, where one bit was dropped 
from block number 100, making it 96. If an I/O request is received 
for block 100 and the tape is positioned at block 98, the driver 
starts searching forward for block 100. The first block to be 
encountered is 96 and because the driver is searching for block 100 in 
a forward direction and 96 is less than 100, the search continues 
forward. Block 101 is the next block, and because number 101 is 
greater than 100, the driver reverses the direction of the tape and 
starts to search backward. The next block number in this direction is 
96 and direction is reversed again, because 100 is greater than 96. 
To prevent the DECtape from being hung in this position, continually 
rocking between block numbers 96 and 100, a maximum rock count of 
eight has been established. 
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4.4.2 Select Recovery 


If the DECtape unit is in an off-line condition when the I/O function 
is performed, the message shown below is output on the operator's 
console. 


*** DTn: <= SELECT ERROR 


where n is the unit number of the drive that is currently off-line. 
The user should respond by placing the unit to REMOTE. The driver 
retries the function, from the beginning, once every second. It 
displays the message once every 15 seconds until the appropriate 
DECtape unit is selected. A select error may also occur when there 
are two drives with the same unit number or when no drive has the 
appropriate unit number. 


4.5 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the DECtape driver described in 


this chapter. 


4.5.1 DECtape Transfers 


If the transfer length on a write is less than 256 words, a partial 
block is transferred with zero fill for the rest of the physical 
block, If the transfer length on a read is less than 256 words, only 
the number of words specified is transferred. If the transfer length 
is greater than 256 words, more than one physical block is 
transferred, 


4.5.2 Reverse Reading and Writing 


The DECtape driver supports reverse reading and writing, because these 
functions speed up data transfers in some cases. A block should 
normally be read in the same direction in which it was written. If a 
block is read from a DECtape into memory in the opposite direction 
from that in which it was written, it is reversed in memory (e.9., 
word 255 becomes word 0, and 254 becomes word 1). If this occurs, the 
user must then reverse the data within memory. 


4.5.3 Speed Considerations When Reversing Direction 


It is possible to reverse direction at any time while reading or 


writing DECtape. However, the user should understand that reversing © 


direction substantially slows down the movement of the tape. Because 
DECtape must be moving at a certain minimum speed before reading or 
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writing can be performed, a tape block cannot be accessed immediately 
after reversing direction. Two blocks must be bypassed before a read 
or write function can be executed, to give the tape unit time to build 
up to normal access speed. Furthermore, when a request is issued to 
read or write in a certain direction, the tape first begins to move in 
that direction, then starts detecting block numbers. The following 
examples illustrate these principles. 


If a DECtape is positioned at block number 12 and the driver receives 
a request to read block 10 forward, the tape starts to move forward, 
in the direction requested. When block number 14 is encountered, the 
driver reverses the direction of the tape, since 14 is greater than 
10. The search continues backward, and block numbers 11 and 10 are 
encountered, Because the direction must be reversed and the driver 
requires two blocks to build up sufficient speed for reading, block 
number 9 and 8 are also bypassed in the backward direction. Then the 
direction is reversed and the driver encounters blocks 8 and 9 forward 
before reaching block number 10 and executing the read request. 


4.5.4 Aborting a Task 


If the user attempts to abort a task which is waiting for a DECtape 
unit to be selected, the unit must actually be selected before the 
task will actually be aborted, : 
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MAGNETIC TAPE DRIVERS 


5.1 INTRODUCTION 


RSX-11M supports two magnetic tape devices, the TMl1l and the TJU16. 
Table 5-1 summarizes these devices and subsequent sections describe 
them in greater detail. 


Table 5=1 
Standard Magtape Devices 


TML1 TIULE 
Number of channels Ford | 9 
Recording density, in frames For 7-channels: 800 or 1600 
per inch 200, 556, or 800; 
for 9=-channel: 
800 . 
Tape speed, in inches per 45 . 45 
second 
Maximum data transfer rate, 36,000 For 800 bpis 
in bytes per second 36,000; 
for 1600 bpi: 
72,000 
Recording Method NRZI NRZI or 
Phase 
Encoding 


Programming for Magtape is quite similar to programming for the 
magnetic tape cassette (see Chapter 6). Unlike cassette, however, 
Magtape can handle variable-length records and allows the user to 
select a parity mode. 


RSX~1L1M does not support a file structure for Magtape. 
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5.1.1 TM1l Magnetic Tape 


The TMll consists of a TMl1 controller with a TU1O transport. It is a 
low-cost, high performance system for serial storage of large volumes 
of data and programs in an industry~-compatible format. All recording 
is non-return-to-zero, inverted (NRZI). 


5.1.2 TJU16 Magnetic Tape 


The TJU16 consist of an RH11 controller, a TM02 formatter, and a TU16 
transport. It is quite similar to the TMll but is a Massbus device, 
with a common controller, a specialized formatter, and a drive. 
Recording is either 800 bpi NRZI or 1600 bpi phase-encoded (PE). 


5.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 


directive (the first characteristics word) contains the following 


information for Magtapes. A bit setting of 1 indicates that the 
described characteristic is true for Magtapes. 


Bit Setting Meaning 
0 0 Record-oriented device 
1 0 Carriage~-control device 
2 0 Terminal device 
3 0 Directory device 
4 0 Single-directory device 
5 1 Sequential device 
6-12 0 Reserved 
13 - 0 Device mountable as a communications 
channel 
14 . 0 Device mountable as a FILES-11 volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates the 
default buffer size, for Magtapes 512 bytes. . 


i 
( 


ERR TE RRR FE EN PRE TEESE BI IEEE BL EGE EB ETE EST EE SEES ADT A EE SEEDED EE BE SAE ES EN RENEE LOCAL TI CAIRNE DEES SADE ASPET AR NSA I HER REMNET 


SARE SES SAR GRA GRE NOSES UE RAO 


TESLA TORTIE eae 


RRCRRRRRRL WER SIRI 


CHAPTER 5. MAGNETIC TAPE DRIVERS 
523 QIO MACRO 


This section summarizes standard and device-specific mto functions for 
the Magtape drivers. 


5.3.1 Standard QIO Functions 


Table 5-2 lists the standard functions of the QIO macro that are waite 
for Magtape. 


Table 5-2 
Standard QIO Functions for Magtape 


Format Function 
QIOSC IO.ATT,...~ . Attach device 
QIO$SC IO.DET,... - Detach device 
QIO$C IO.KIL,... Cancel I/O requests 
QIOSC IO.RLB,...,<stadd,size> Read logical block 


(read tape into buffer) 


QIOSC IO.RVB,...,<stadd,size> Read virtual block ' 
(read tape into buffer) : 


QIO$C IO.WLB,...,<stadd,size> Write logical block 
a (write buffer contents to tape) 


QIO$C IO.WVB,...,<stadd,size> Write virtual block 
(write buffer contents to tape) 
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where: stadd is the starting address of the data buffer (must be on 
a word boundary) . 


-gize is the data buffer size in bytes (must be even, greater 
than zero, and, for a write, must be at least 14 — 


bytes). 
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IO.KIL does not cancel an in progress request unless a select error 
has occurred. 


ABR AAD PEREE RO ER BPR SEE SEES LSS NE AS EBS Y EDEL ODES ES IEEE 


ROMERO RS 


CHAPTER 5. MAGNETIC TAPE DRIVERS 


5.3.2 Device-Specific QIO Functions 


Table 5-3 lists the device-specific functions of the QIO macro. that 
are valid for Magtape. Additional details on certain functions appear 
below. 


Table 5<3 
Device~Specific QIO Functions for Magtape 


Format Function 
QIOSC IO.EOF,... Write end-of-file mark (tape mark) 
QIOS$C IO.RWD,... Rewind unit | 
QIOSC I0.RWU,... Rewind and turn unit off-line 
QIOSC IO.SEC,... Read tape characteristics 
QIOSC I0.SMO,...,<cb> Mount tape and set tape characteristics 
QIOSC IO.SPB,...,<nbs> Space blocks 
QIOSC IO.SPF,...,<nes> Space files 
QIOSC I0.STC,...,<cb> Set tape characteristics 
wheres cb represents the characteristic bits to set. 


nbs is the number of blocks to space past (positive if 
forward, negative if reverse). 


nes is the number of EOF marks to space past (positive if 
forward, negative if reverse). 


5.3.2.1 IO.RWU — IO.RWU is normally used when operator intervention 
is required (e.g., to load a new tape). The operator must turn the 
unit back on-line manually before subsequent operations can proceed. 
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5.3.2.2 I0.SEC - This function returns the tape characteristics in 
the second I/O status word, The tape characteristic bits are defined 
as follows: . 


Can Be Set by 


Bit Meaning When Set IO.SMO and I0.STC 
0 For TMl1, 556 bpi density x 


(seven-channel). For 
TJU16, reserved 


1 For TMl1, 200 bpi density x 
(seven=-channel). For 
TJU16, reserved, 


2 For TMl1l, core~dump mode x 
(seven-channel, see below). 
For TJU16, reserved. 


3 Even parity (default is odd). x 
4 Tape is past EOT. 
5 Last tape command encountered 


EOF (unless last command was 
backspace). 


‘ 6 Writing is prohibited. * 


7 Writing with extended inter- x 
record gap is prohibited 
(i.e., no recovery is attempted 
after write error). 


8 Select error on unit (reserved 
for driver; always 0 when read 
by user). 


( 9 Unit is rewinding (reserved for 
as driver; always 0 when read by 
user). 
10 Tape is physically write-locked. 
ll For TMll, reserved. For TJU16, 
1600 bpi density. 
12 For TMll1, drive is seven-channel. 
For TJU16, reserved. 
13 Tape is at load point (BOT). 
14 Tape is at end-of-volume (EOV). 
15 Tape is past EOV. 


1] 
| 
Ul 


SIRES ERR IIS NE LT ET TESTE AEG GSES DELS ETM SES DELL BCE EELS RENEE AR BESET EE ELI EEL AE EN EE IEIEEAE EME REET EOA TI LIES RE DECI AEE A ANAL ES SINEMA NE NCI NN 


SSSR SE aE SER A ESTER 


PDEA GEE TREE EIS SL LEBEL ARES EGET 


eT RATS 


SRASERTSEES SHEETS 


oS LORS IOT TORS. EE. 


CHAPTER 5. MAGNETIC TAPE DRIVERS 


In core-dump mode (TMll only, 800 bpi density, and seven-channel), 
each eight-bit byte is written on two tape frames, four bits per 
frame. In other modes on seven-channel tape, only six low-order bits. 
per byte are written. 


The effect of these settings is illustrated in Figure 5-1 for the TM1l 
and in Figure 5-2 for TJUI16. 
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Figure 5=1 
Determination of Tape Characteristics 
for the TM11 
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1600 BPI? 


SET 1600 BPI 


SET 800 BPI 


SET 
EVEN PARITY 


Figure 5-2 
Determination of Tape Characteristics 
for the TJU16 
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5.4 STATUS RETURNS 


The error and status conditions listed in Table 5-4 are returned by 
the Magtape drivers described in this chapter. 


Code 


IS.SUC 


IS.PND 


IE. ABO 


IF.BBE 


IE.BYT 


IE.DAA 


Table 5-4 
Magtape Status Returns 


Reason 
Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if operation involved reading or 
writing. This code is also returned if nbs equals zero 
in an I0.SPB function or if nes equals zero in an 
IO.SPF function. 


I/O request pending 


The operation specified in the QIO directive has not 
yet been executed, The I/O status block is filled with 
ZexroS. 


Operation aborted 


The specified I/O operation was cancelled via I0.KIL 
while in progress or while still in the I/O queue. 


Bad block 


A bad block was encountered while reading or writing 
and the error persists after nine retries. The number 
of bytes transferred is returned in the second word of 
the I/O status. block. For TMll, IE.BBE may also 
indicate that a bad tape error (BTE) has been 
encountered while reading or spacing. 


Byte-aligned buffer specified 


Byte alignment was specified for a buffer, but only 
word alignment is legal for Magtape. Alternately, the 
length of a buffer is not an even number of bytes. 


Device already attached 


The physical device unit specified in an IO.ATT 
function was already attached bv the issuing task, 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task. 
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Code 


IE.DAO 


IE.DNA 


IE.DNR 


IE. EOF 


IE.EOT 
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Table 5-4 (Cont.) 
Magtape Status Returns 


Reason 
Data overrun 


On a read, a record exceeded the stated buffer size. 
The final portion of the buffer is checked for parity, 
but is not read into memory. 


Device not attached 


The physical. device unit specified in an IO.DET 
function was not attached by the issuing task. This 
code has no bearing on the attachment status of other 
tasks. 


Device not ready 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
This code is returned to indicate one of the following 
conditions: 


. A timeout occurred on the physical device unit (i.e., 
an interrupt was lost). 


- A vacuum failure occurred on the Magtape drive. 


- While trying to read or space, the driver detected 
blank tape. 


» The "LOAD" switch on the physical drive was switched 
to the off position, 


End-of-file encountered 
An end-of-file (tapemark) was encountered, 
End-of-tape encountered 


The end-of-tape (physical end-of-volume) was 
encountered while the tape was moving in the forward 
direction. A ten-foot length of tape is provided past 
EOT to be used for writing data and markers, such as 
volume trailer labels. The IE.EOT code will continue 
to be returned in the I/O status block until the EOT 
marker is passed in the reverse direction, 
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Code 


IE.EOV 


IE.FHE 


IE.IFC 


ITE.OFL 


IE.SPC 


IE .WLK 
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Table 5-4 (Cont.) 
Magtape Status Returns 


Reason 
End=-of—volume encountered 


On a forward spacing function, the logical 
end-o f-volume (two consecutive EOF marks) was 
encountered. The tape is normally left positioned 
between the two EOF marks. 


Fatal hardware error 
Fatal hardware malfunction. 
Illegal function 


A function code was specified in an I/O request that is 
illegal for Magtape. 


Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Tllegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. For Magtape, this code is also returned 
if a byte count of zero was specified or if the user 
attempted to write a block that was less than 14 bytes 
long. 


Unrecoverable error 


After the system's standard number of retries has been 
attempted upon encountering an error, the operation 
still could not be completed. For Magtape, this code 
is returned in the case of CRC or checksum errors or 
when a tape block could not be read, 


Write-locked device 


The task attempted to write on a Magtape unit that was 
physically write-locked. Alternately, tape 
Characteristic bit 6 was set by the software to 
write-lock the unit logically. 
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After read and write functions, the second I/O status word contains 
the number of bytes actually processed by the function. After spacing 
functions, it contains the number of blocks of files spaced over. The 
EOF mark counts as one block. If an EOF mark is encountered by a read 
operation, the second I/O status word will contain an octal two. 


5.4.1 Select Recovery 


If a request fails because the desired unit is off-line, no drive has 
the desired unit number, or has its power off, the following message 
is output on the operator's console: 


*** MIn; -- SELECT ERROR 


where n is the unit number of the specified drive. The driver checks 
the unit for readiness and repeats the message every 15 seconds until 
the requesting task is aborted or the unit is made available. In the 
latter case, the driver then proceeds with the request. 


5.4.2 Retry Procedures for Reads and Writes 


If an error occurs during a read (e.g., vertical parity error), the 
recovery procedure depends on the type of Magtape in use. A bad tape 
error on a TMll results in an immediate return of the error code 
IE.BBE. All other read errors for both the TM1l and TJU16 are retried 
by backspacing one record and then rereading the record in question. 
If the error persists after nine retries, IE.BBE is returned, 


Write recovery is the same for both the TM11 and TJU16. When a write 
operation fails the driver attempts to avoid the bad spot on the tape 
by means of an extended interrecord gap (IRG). This means that it 
backspaces, makes the IRG just before the record three inches longer, 
and then retries the write. If the error persists after nine retries, 
IE.BBE is returned, The requesting task can use I0.STC to prohibit 
writing with an extended interrecord gap. In this case, IE.BBE is 
returned as soon as a write fails. 


5.5 PROGRAMMING HINTS 


This section contains information on important programming 
consicerations relevant to users of the Magtape drivers described in 
this chapter. 


5.5.1 Block Size 


Each block must contain an even number of bytes, at least 14 for a 
write anda most 65,534, It is more reasonable; however, to work 


with a block size of approximately 2,048 bvtes. 
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5.5.2 Importance of Resetting Tape Characteristics 


A task that uses Magtape should always set the tape characteristics to 
the proper value before beginning I/O operations. The task cannot be 
certain in what state the previous task left these characteristics. 
It is also possible that an operator might have changed the Magtape 
unit selection. If the selection switch is changed, the new physical 
device unit may not correspond to the characteristics of the unit 
described by the respective unit control block. 


5.5.3 Aborting a Task 


If a task is aborted while waiting for a Magtape unit to be selected, 
the Magtape driver recognizes this fact within 15 seconds. It is not 
necessary to select the Magtape unit before aborting the task, as is 
the case for DECtape,. 


5.5.4 Writing an Even-Parity Zero 


If an even=-parity zero were written normally, it would appear to the 
drive as blank tape. It is therefore converted to 20 (octal). If 
this conversion is undesirable, the user must ensure that no 
even-parity zeros are output on the tape. 


SR RA CT SRSA TER STS REE ESATA SST EE SET AT BBG SEE ES ERNE A CEASERS BN AAI EE AEROS RE ESAS ESOP BESOIN NPIS RSME a RN ARR 


CT eee eee eee 


geo PRES 


Ripon 


Daesewea cnternstset scenes nt ener ethene re emer te tne teen anc sentra et te hee te et eh tee I Bt rt teeta nee BT sod ded snenad nance nena ioseatomensmenidele 


( 


CHAPTER 6 


CASSETTE DRIVER 


6.1 INTRODUCTION 


RSX-11M supports the TA11 magnetic tape cassette (a TAl1l controller 
with a TU60 dual transport). Programming for cassette is quite 


similar to programming for Magtape (see Chapter 5). The fTA11l system . 


is a dual-drive, reel-to-reel unit designed to replace paper tape. 
Its two drives run nonsimultaneously, using Digital proprietary 
Philips-type cassettes. 


The maximum capacity of a cassette, in bytes, is 92,000 (minus 300 per 


file gap and 46 per interrecord gap). It can transfer data at speeds 
of up to 562 bytes per second. Recording density ranges from 350 to 
700 bits per inch, depending on tape position. 


6.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 
directive (the first characteristics word) contains the following 
information for cassettes. A bit setting of 1 indicates that the 
described characteristic is true for cassettes. 
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Bit Setting Meaning 
0 1 Record=oriented device 
1 0 Carriage-control device 
2 0 Terminal device 
3 0 Directory device 
4 0 Single-directory device 
5 1 Sequential device 
6-12 0 Reserved 
13 0 Device mountable as a communications 
channel | 
14 0 Device mountable as a FILES=11 volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates the 
default buffer size, for cassettes 128 bytes. 


6.3 QIO MACRO 


This section summarizes standard and device-specific QIO functions for 
the cassette driver. 
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6.3.1 Standard QIO Functions 


Table 6-1 lists the standard functions of the QIO macro that are valid 


for cassette, 


Table 6-1 
Standard QIO Functions for Cassette 


Format Function 
QIOSC IO.ATT,... Attach device 
QIOSC IO.DET,...- Detach device 
QITOSC IO.KIL,... Cancel I/O requests 
QTOSC IO.RLB,...,<stadd,size> Read logical block 


(read tape into buffer) 


QIO$SC IO.RVB,...,<stadd,size> Read virtual block 
(read tape into buffer) 


QIOSC IO.WLB,...,<stadd,size> Write logical block 
(write buffer contents to tape) 


QIOSC IO.WVB,...,<stadd,size> Write virtual block 
(write buffer contents to tape) 


where: stadd is the starting address of the data buffer (may be ona 
byte boundary). 


Size is the data buffer size in bytes (must be greater than 
zero). 


IO.KIL does not affect in progress requests. 


6.3.2 Device-Specific QIO Functions 


Table 6-2 lists the device-specific functions of the QIO macro that 
are valid for cassette. The section on programming hints below 
provides more detailed information about certain functions. 


LTS SRE TTR ELI EL GET EE ILE TL OY GHEE SEIS ESSE BS BBG SE SSRIS UT SBE ERE IA AB RIES IAT ESOS HODES ICE BA EL HNIC HEE EASES BIEN EON UMC Ea OE Oe Ao: 


SDSL BA SATA SEH AIST IRIE BEA IIRER IRE 


ASS EER ESI TI SE WAS BES BILE TY BERS EVEL ERE GS A TSE E TE SEE EE ET TE EE RTE GOCE ARE RE TEE A TREES EEG 


Aes FATE RRDY PFE NABH AREAL EN OR NSN ETS 


Re RRR RE ZIT ESBS: 


CHAPTER 6. CASSETTE DRIVER 


Table 6-2 
Device-Specific QIO Functions for Cassette 


Format | Function 
QIOSC IO.EOF,... Write end-of-file gap 
QIOSC LO.RWD yess _ Rewind unit 
QIOSC I0.SPB,...,<nbs> | Space blocks 
QIOSC IO.SPF,...,<nes> Space files 


where: nbs is the number of blocks to space past 
forward, negative if reverse). 


nes is the number of EOF gaps to space past 
forward, negative if reverse). 


6.4 STATUS RETURNS 


The error and status conditions listed in Table 6-3 are 


the cassette driver described in this chapter. 


Table 6-3 
Cassette Status Returns 
Code Reason 
Is.Suc Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/0 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing, or the number of blocks or files 
the operation involved spacing blocks or files... 


IS.PND I/O request pending 


The operation specified in the QIO directive has 
yet been executed. The I/O status block is filled with 


zeros. 


IE.ABO Operation aborted 


The specified I/O operation was cancelled via I0.KIL 


while still in the I/O queue. 
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Code 


IE.DAA 


IE. DAO 


IE.DNA 


IE.DNR 


IE. EOF 
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Table 6-3 (Cont.) 
Cassette Status Returns 


Reason 


Device already attached 


The physical device unit specified in an IO.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task, 


Data overrun 


The driver was not able to sustain the data rate 
required by the TA11 controller, 


Device not attached 


The physical device unit specified by an IO.DET 
function was not attached by the issuing task. This 
code has no bearing on the attachment status of other 
tasks. 


Device not ready 
The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 


This code is returned to indicate one of the following 
conditions: 


. The cassette has not been physically inserted, 
. The unit is off-line. 


- A timeout occurred on the physical device unit (i.e., 
an interrupt was lost). 


End-of-file encountered 


An end-of-file gap was recognized on the cassette tape. 
This code is returned if an EOF gap is encountered 
during a read or if the cassette is physically removed 
during an I/O operation. 
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IE.EOT 


IE.IFC 


ITE.OFL 


IE.SPC 


IE.VER 
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Table 6-3 (Cont.) 
Cassette Status Returns 


Reason 
End-of-tape encountered 


While reading or writing, clear trailer at end-of-tape 
(EOT) was encountered. Unlike Magtape, writing beyond 
EOT is not permitted on cassettes. This condition is 
always sensed on a write before it would be sensed on a 
read of the same section of tape. If IE.EOT is 
returned during a write, the cassette head has 
encountered EOT before finishing the writing of the 
last block. It is recommended that the user rewrite 
the block on another cassette in its entirety. 


Illegal function 


A function code was specified in an I/O request that is 
illegal for cassette. 


Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Illegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately, a byte count of zero was 
specified on a transfer. 


Unrecoverable error 


This code is returned when a block check error occurs 
(see section 6.6.5). The cyclic redundancy check 
(CRC), a two-byte value located at the end of each 
block, is a checksum that is tested during all read 
operations to ensure that data is read correctly. Tf 
an unrecoverable error is returned, the user may 
attempt recovery by spacing backward one block and 
retrying the read operation. 


Write-locked device 


The task attempted to write on a cassette unit that was 
physically write-locked. This code may be returned 
after an IO.WLB, IO.WVB, or IO.BOF function, 
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6.4.1 Cassette Recovery Procedures 


If an error occurs during a read or write operation, the operation 
should be retried several times. The recommended maximum number of 
retries is nine for a read and three for a write because each retry 
involves backspacing, which does not always position the tape in the 
same place. More than three retries of a write operation may destroy 
previously written data. For example, to retry a write, it is best to 
space two blocks in reverse, then space one block forward. This 
insures the tape is in the proper position to rewrite the block that 
encountered the error. 


After read and write functions, the second I/O status word contains 
the number of bytes actually processed by the function. After spacing 
functions, it contains the number of blocks or files actually spaced. 


a 


6.5 STRUCTURE OF CASSETTE TAPE 


Figure 6-1 illustrates a general structure for cassette tape. A 
different structure can be employed if the user wishes. 


Here the tape consists of blocks of data interspersed with sections of 
clear tape that serve as leader, trailer, interrecord gaps (IRGs), and 
end-of-file gaps. 


The logical end-of-tape in this case consists of a sentinel label 
record, rather than the conventional group of end-of-file gaps. Each 
file must contain at least one block. The size of each block depends 
upon the number of bytes the user specifies when writing the block. 
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Figure 6-1 
Structure of Cassette Tape 
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Abbreviation Meaning 
CL Clear leader 
BOT Physical beginning-of-tape 
LPG Load point gap (blank tape written by driver before the 

first retrievable record) 

LR File label record 
REC Fixed-length record (data) 
EOF End-of-file gap 
IRG Interrecord gap 
SLR Sentinel label record 
LEOT Logical end-of-tape 
BOT Physical end-of-tape 
CT Clear trailer 


6.6 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the cassette driver described in 


this chapter. 


6.6.1 Importance of Rewinding 


The first cassette operation performed on a tape must always be a 
rewind to ensure that the tape is positioned to a known place. When 
it is positioned in clear tape there is no way to determine whether it 
is in leader at the beginning-of-tape (BOT) or in trailer at the 
end-of-tape (EOT). 
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The hardware senses end-of-file (EOF) as a timeout. When I0.SPF is 
issued in the forward direction (nes is positive), the tape is 
positioned two-thirds of the way from the beginning of the final file 
gap. In effect, this is all the way through the file gap. When 
IO.SPF is issued in the reverse direction (nes is negative), the tape 
is positioned one-third of the way from the beginning of the final 
file gap (i.e., two thirds of the way from the beginning of the last 
file spaced). Therefore to correctly position the tape for a read or 
write after issuing IO.SPF in reverse, the user should issue I0O.SPB 
forward for one block, followed by I0.SPB in reverse for one block. 


6.6.3 The Space Functions, IO.SPB and IO.SPF 


IO.SPB always stops in an IRG, IO.SPF in an EOF gaps. Neither space 
function actually takes effect until data are encountered. For 
example, suppose the tape is positioned in clear leader at BOT and the 
user requests that one block be spaced forward. The drive passes over 
the remaining leader until it reaches data, passes one block, and 
stops in the IRG. Similarly, if the same command is issued when the 
tape is at BOT on a blank tape or a tape containing only EOF gaps, the 
function does not terminate until EOT. 


6.6.4 Verification of Write Operations 


Certain errors, such as cyclic redundancy check, are detected on read 
but not write operations. Therefore, to ensure reliability of 
recording, it is recommended that the user perform a read as 
verification of every write operation. 


6.6.5 Block Length 


The user must specify the exact number of bytes per block when 
requesting read or write operations. An attempt to read a block with 
an incorrect byte count causes an unrecoverable error (see section 
6.4) to occur, 


6.6.6 Logical Fnd~of-Tape 


The conventional method of signaling logical end-of-tape by multiple 
EOF gaps is inadequate for cassettes. This is because multiple FOF 
gaps are not distinguishable from each other. For example, two 
sequential EOF gaps would be read as three instead of two. Also 
spacing functions, since they are triggered by encountering data, can 
not recognize multiple EOF gaps. Consequently, the use of a sentinel 
or key record to signal logical end-of-tape is recommended. 
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CHAPTER 7 
LINE PRINTER DRIVER 
pass 7,1 INTRODUCTION 
The RSX-11M line printer driver supports the line printers summarized 


in Table 7-1. Subsequent sections of this chapter describe these 
printers in greater detail. 


Table 7-1 
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Model Column Width 
LP1L1-F 80 

LPL1<-H 80 

LPll-J 132 

LP11I-K 132 

LP11-R 132 

LP11-sS 132 

LS11 132 

LV11l 


132 


Character Set 


Standard Line Printer Devices 


64 
96 
64 
96 
64 
96 
62 


96 


Lines per Minute 


170-1110 
170-1110 
170-1110 
170-1110 
1110 
1110 
60-200 
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7e1e1 LP1l Line Printer 


The LPll is a high-speed line printer available in a variety of 
models. The entire LP1ll line consists of impact printers, using one 
hammer per column and a revolving drum with upper-case and optional 
lower-case characters. The LP1ll-R and ULPll-S are fully buffered 
models which operate at a standard speed of 1110 lines per minute. 
The other LP1l models have 20-character print buffers. These printers 
are therefore able to print at full speed if the print line is no 
longer than 20 characters. Lines which exceed this maximum are 
printed at a slower rate. Forms with up to six parts may be used for 
multiple copies. 


9423 LS11 Line Printer 


The LS11 is a medium-speed line printer. It has a 20-character print 
buffer, and lines of 20 characters or less are printed at a rate of 
200 lines per minute. Longer lines are printed at a slower rate. 
RSX-1L1M does not support the LS11 expanded character set feature. 


7.1.23 LV1l Line Printer 


The LV11l is a fully-buffered electrostatic printer-plotter which 
Operates at a standard rate of 500 lines per minute. RSX=-11M supports 
Only the LV11l print capability, not the plotter mode. 


7.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled hy the GET LUN INFORMATION syster 

ivective (the first characteristics word) contains the following 
information for line printers. A bit setting of 1 indicates that the 
described characteristic is true for line printers. 


Bit Setting Meaning 
0 a Record-oriented device 
at 1 Carriage-control device 
2 0 Terminal device 
Ks 0 Directory device 
4 2% Single-directory device 
5 0 Sequential device 
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Bit Setting Meaning 
6-12 0 Reserved 
13 0 Device mountable as a communications 
channel 
14 0 Device mountable as a FILES-11 volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates he 
default buffer size for the device, for line printers the width of the 
printer carriage (i.e., 80 or 132). 


723 OIO MACRO 
Table 7-2 lists the standard functions of the QIO macro that are valid 


for line printers. 


Table 7-2 
Standard QIO Functions for Line Printers 


Format Function 
QIOSC IO.ATT,..-~ Attach device 
QIOSC IO.DET,... Detach device | 
QTOSC IO.KIL,... Cancel I/O requests 


QTOSC IO.WLB,+ ee ,<Stadd,size,vfc> Write logical block (print buffer 
contents) 


QIOSC IO.WVB,...,<stadd,size,vfc> Write virtual hlock (print huffer 
contents) 


wheres: stadd is the starting address of the cata buffer (may be ona 
byte boundary). : 


size is the data buffer size in bytes (must be greater than 
ZetO). 


vfc is a vertical format control character from Table 7-4, 
IO.KIIL does not cancel an in progress request unless the line printer 
is in an offline condition because of a power failure or a paper jam 


or because it is out of paper. 


“he line printer driver supports no device-specific functicns. 
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LINE PRINTER DRIVER 


7.4 STATUS RETURNS 


Table 7-3 lists the error and status conditions that are returned by 
the line printer driver described in this chapter. 


Code 


IS.SsuUC 


IS.PND 


IE. ABO 


IE.DAA 


IE.DNA 


Table 7-3 
Line Printer Status Returns 


Reason 


Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if the operation involved writing. 


I/O request pending 


The operation specified in the QIO directive has not 
yet been executed. The I/O status block is filled with 
ZeLOS. 


Operation aborted 


The specified I/O operation was canceled while in 
progress or while in the I/O queue. 


Device already attached. 


The physical device unit specified in an I0.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task. 


Device not attached 
The physical device unit specified an IO.DET function 


was not attached by the issuing task. This code has no 
bearing on the attachment status of other tasks. 
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Table 7-3 (Cont.) 
Line Printer Status Returns 


Code Reason 


IE.IFC Illegal function 


A function code was specified in an I/O request that is 
illegal for line printers. 


IE.OFL Device off-line 
The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device. check indicated that 
this physical device unit was not in the configuration. 
IE.SPC Illegal address space 
The buffer specified for a write request was partially 


or totally outside the address space of the issuing 
task. Alternately, a byte count of zero was specified. 


7.4.1 Ready Recovery 

If any of the following conditions occur: 
e Paper jam | 
° Printer out of paper 
-. Printer turned off-line 


‘ Power failure 


the driver determines that the line printer is off-line, and the 


following message is output on the operator's console: 
*** LPns -— NOT READY 


where n is the unit number of the line printer that is not ready. The 
driver retries the function which encountered the error condition from 
the beginning, once every second. It displays the message every 15 
seconds until the line printer is readied. If a power failure occurs 
while printing a line, the entire line is reprinted from the beginning 
when power is restored. 
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7.5 VERTICAL FORMAT CONTROL 


Table 7-4 summarizes the meaning of all characters used for vertical 
format control on the line printer. Any one of these characters can 
be specified as the vfc parameter in an IO.WLB or IO.WVB function, 


Table 7-4 
Vertical Format Control Characters 


Octal 

Value Character Meaning 

040 blank SINGLE SPACE: output a line feed, print the 
contents of the buffer, and output a carriage 
return. Normally, printing immediately follows 
the previously printed line. 

060 _ zero DOUBLE SPACE: output two line feeds, print the 
contents of the buffer, and output a carriage 
return. Normally, the buffer contents are printed 
two lines below the previously printed line. 

061 one PAGE EJECT: output a form feed, print the 
contents of the buffer, and output a carriage 
return. Normally, the contents of the buffer are 
printed on the first line of the next page. 

053 plus OVERPRINT: print the contents of the buffer and 
perform a carriage return, normally overprinting 
the previous line, 

044 dollar PROMPTING OUTPUT: output a line feed and then 

sign print the contents of the buffer. 

000 null INTERNAL VERTICAL FORMAT: the buffer contents are 


printed without addition of vertical format 
control characters. In this mode, more than one 
line of guaranteed contiguous output can be 
printed per I/O request. 


All other vertical format control characters are interpreted as blanks 
(octal 040). 


7.6 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the line printer driver described 


in this chapter. 
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7.6.1 RUBOUT Character 


The line printer driver discards the ASCII character code 177 during 
output, because a RUBOUT on the LS1l1 printer causes a RUBOUT of the 
hardware print buffer, 


7.6.2 Print Line Truncation 


If the number of characters to be printed exceeds the width of the 
print carriage, the driver discards excess characters until it 
receives one that instructs it to empty the buffer and return to 
horizontal position l. The user can determine that truncation will 
occur by issuing a GET LUN INFORMATION system directive and examining 
word 5 of the information buffer. This word contains the width of the 
print carriage in bytes. 


7.6.3 Aborting a Task 


If a task is aborted while waiting for the line printer to be readied, 
the line printer driver recognizes this fact within one second. It is 
not necessary to ready the printer before aborting the task, as is the 
case for DECtape. 
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CHAPTER 8 


CARD READER DRIVER 


8.1 INTRODUCTION 


The RSX-11M card reader driver supports the CRl1I card reader.  MThis 
reader is a virtually jam-proof device which reads EIA standard 
80-—column punched cards at the rate of 300 per minute. The hopper can 
hold 600 cards. This device uses a vacuum picker which provides 
extreme tolerance to damaged cards and makes card wear insignificant. 
Cards are riffled in the hopper to prevent sticking. The reader uses 
a strong vacuum to deliver the bottom card, It has a very short card 
track, so only one card is in motion at a time. | 


8.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 
directive (the first characteristics word) contains the following 
information for card readers. A bit setting of 1 indicates that the 
described characteristic is true for card readers. 
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Bit Setting Meaning 

0 1 Record=-oriented device 

1 0 Carriage-control device 

2 0 Terminal device 

3 0 Directory device 

4 0 Single-directory device 

5 0 Sequential device 
6-12 0 Reserved 

13 0 Device mountable as a communications 

channel 

14 0 Device mountable as a FILES-ll volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates the 
default buffer size, which is 80 bytes for the card reader. 


8.3 QIO MACRO 


This section summarizes standard and POV FCe=eReCrELe QIO functions for 
the card reader driver. 


8.3.1 Standard QIO Functions 


Table 8-1 lists the standard functions of the QIO macro that are valid 
for the card reader. 


: a 


| daca fai Zac 11 ia nim a encanta nnaaaenneemtnaingsiameanieameiaaaamniaieaadeemmnatnamnmemmneaeianoamenemedsmmietmmmiammnmdmannamenimmetmmaEmmtNE 


SACLE TE SE ITER TOE BITE ETE TAAL 


ececeeeeat teen ee 


SE SERS AGB STFS BS LG BEES IEE SESS BN ESE BB ER 


SHE RA TSLAE AEB Y ORT ES 
i 


Se a eee 


¥ ™, 


CHAPTER 8. CARD READER DRIVER 


Table 8-1 
Standard QIO Functions for the Card Reader 


Format Function 
QIO$C IO.ATT,... Attach device 
QIOSC IO.DET,... Detach device 
QIOSC I0.KIL,..e.~ Cancel I/O requests 
QIOSC IO.RLB,...,<stadd,size> Read logical block (alphanumeric) 
QIOSC IO.RVB,...,<stadd,size> Read virtual block (alphanumeric) 


where: stadd is the starting address of the data buffer (may be on a 
byte boundary). 


size is the data buffer size in bytes (must be greater than 
Zero) . 


IO.KIL does not cancel an in progress request unless the card reader 
is in an offline condition because of a pick, read, stack, or hopper 
check, because of power failure, or because the RESET button has not 
been depressed, 


8.3.2 Device-Specific QIO Function 
The device-specific function of the QIO macro that is valid for the 
card reader is shown in Table 82, 


Table 8=2 
Device-Specific QIO Function for the Card Reader 


Format Function 


QIOSC IO.RDB,...,<stadd,size> Read logical block (binary) 


wheres: stadd is the starting address of the data buffer (may be ona 
byte boundary). 


size is the data buffer size in bytes (must be greater than 
ZeXO) . 
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8.4 STATUS RETURNS 


There are a wide variety of error conditions and recovery procedures 
related to the use of the card reader. This section describes the 
three major ways in which the system reports error conditions. 


1. Lights and indicators on the card reader panel are turned on 
or off to indicate particular operational problems such as 
read, pick, stack, or hopper checks. Switches are available 
to turn the reader power on and off and to allow the user to 
reset after correcting an error condition, 


2. A message is output on the operator's console if operational 
checks or power problems occur, 


3. An I/O completion code is returned in the low-order byte of 
the first word of the I/O status block specified in the QIO 
macro to indicate success or failure on completion of an I/O 
function, 


The following subsections describe each of these returns in detail. 


8.4.1 Card Input Errors and Recovery 


The table included below describes all external lights and switches 
used to indicate to the operator that a hardware problem has occurred 
and must be corrected. There are two classes of hardware errors: 


« Those requiring the operator to ready the reader and try the 
operation again. 


« Those requiring the operator to remove the last card from the 
output stacker, to replace it in the input hopper, and to try 
the operation again. 


In the first case, the card reader was unable to read the current 
card, In the second, the card was read incorrectly and must be 
physically removed from the output stacker. The card reader driver 
automatically restarts a read operation within one second after the 
cards have been replaced in the input hopper. 


Table 8-3 summarizes the functions of lights and indicators on the 
front panel of the card reader. It discusses common operational 
errors which might be encountered while reading cards and recovery 
procedures associated with these error conditions. 
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Indicator 


POWER 
switch 


READ 
CHECK 
indicator 


tC 
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Table 8=3 


Card Reader Switches and Indicators 


Description 


pushbutton 
indicator 
switch 
(alternate 
action: 
pressed for 
both ON and 
OFF) 


white light 


Action 


Controls application 
of all power to the 
card reader. 


When indicator is 

off, depressing switch 
applies power to 
reader and causes 
associated indica- 

tor to light. 


When indicator is 
lit, depressing 
switch removes all 
power from reader and 
causes indicator to 
go out. 


When lit, this light 
indicates that the 
card just read may be 
torn on the leading or 
trailing edges, or 
that the card may 

have punches in 

column positions 0 

or 8l. 


Because READ CHECK 
indicates an error 
condition , whenever 
this indicator is 
lit, it causes the 
card reader to stop 
operation and extin- 
guishes the RESET 
indicator. 


Recovery 


Card may have been 
read incorrectly; 
restore power if 
possible by depress- 
ing the POWER 
switch; insert the 
card again as the 
first card in the 
input hopper, and 
press the RESET 
switch; in some 
cases, it may be 
necessary to 
restart the program. 


Card was read incor- 
rectly; duplicate if 
necessary, insert 
the card again as 


the first card in the 


input hopper and 
press the RESET 
switch. 
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Indicator 


PICK 
CHECK 
indicator 


STACK 
CHECK 
indicator 


HOPPER 
CHECK 
indicator 
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Table 8=3 (Cont.) 


Card Reader Switches and Indicators 


Description 


white light 


white light 


white light 


Action 


When lit, this light 
indicates that the 
card reader failed to 
move a card into the 
read station after 
it received a READ 
COMMAND from the 
controller, 


Stops card reader 
operation and extin- 
guishes RESET 
indicator. 


When lit, this light 
indicates that the 
previous card was not 
properly seated in 
the output stacker 
and therefore may be 
badly mutilated. 


Stops card reader 
operation and ex- 
tinguishes RESET 
indicator. 


When lit, this light 
indicates that either 
the input hopper is 
empty or that the out- 
put stacker is full. 


Recovery 


Card could not be 
read; press the 
RESET switch to try 
again or remove the 
cards from the input 
hopper, smooth the 
leading edges, re=- 
place, and then 
press the RESET 
switch. 


Card may have been 
read incorrectly and 
is not positioned 
properly in the out- 
put stacker; dupli- 
cate the card if it 
is damaged; insert 
the card again as 
the first card in 
the input hopper and 
press the RESET 
switch. 


Card may have been 
read incorrectly; 
empty the stacker or 
fill the hopper; in- 
sert the card again 
as the first card in 
the input hopper and 
press the RESET 
switch. 
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Indicator 


STOP 
switch 


RESET 
switch 


/ 
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Card Reader Switches and Indicators 


Description 


momentary 
pushbutton/ 
indicator 
switch 

(red light) 


momentary 
pushbutton/ 
indicator 
switch 
(green 
light) 


Table 8-3 (Cont.) 


Action 


When depressed, 
immediately lights 
and drops the READY 
line, thereby extin- 
guishing the RESET 
indicator. Card 
reader operation then 
stops as soon as the 
card currently in the 
read station has been 
read. 


This switch has no 
effect on the system 
power; it only stops 
the current operation. 


When depressed and 
“released, clears all 
error flip-flops and 
initializes card 
reader logic. Associ- 
ated RESET indicator 
lights to indicate 
that the READY signal 
is applied to the con-=- 
troller. — 


The RESET indicator 
goes out whenever the 
STOP switch is de- 
pressed or whenever 
an error indicator 
lights (READ CHECK, 
PICK CHECK, STACK 
CHECK, or HOPPER 
CHECK) . 


8.4.2 Ready and Card Reader Check Recovery 


If any of the following conditions occurs: 


POWER failure 


reset switch not pressed (reader offline) 
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CHAPTER 8. CARD READER DRIVER 
the driver determines that the card reader is not ready, and the 
following message is output on the operator's console: 
*** CRns -- NOT READY 
If any of the following conditions occurs: 
» Pick error (PICK CHECK) 
« Read error (READ CHECK) 
« Output stacker error (STACK CHECK) 
e Input hopper out of cards (HOPPER CHECK) 
e Output stacker full (HOPPER CHECK) 


the driver determines that a card reader check has occurred, and the 
following message is output on the operator's console: 


*** CRn: -- READ FAILURE. CHECK HARDWARE STATUS 


where n is the unit number of the card reader that is not ready. The 
operator should correct the error and press RESET: the driver 
attempts the function from the beginning, once every second. It 
displays the message once every 15 seconds until the card reader is 
readied, In all cases except pick error, the last card read should be 
reinserted in the input hopper, as described in section 8.4.1. 


8.4.3 I/O Status Condition 


The error and status conditions listed in Table 8-4 are returned by 
the card reader driver described in this chapter. 
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Code 


IS.SUC 


IS.PND 


IE.ABO 


IE.DAA 


IE.DNA 


IE.EOF 


IE.IFC 


IE.NOD 
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Table 8-4 
Card Reader Status Returns 


Reason 


Successful completion 


The operation specified in the QIO directive was _ 


completed successfully. The second word of the I/0 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading. 


I/O request pending 

The operation specified in the QIO directive has not 
yet been executed, The I/O status block is filled with 
ZeLrOS. 


Operation aborted 


The specified I/O operation was canceled while in 
progress or while still in the I/O queue. 


Device already. attached 


The physical device unit specified in an IO,.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that the 
unit was attached by another task. 


Device not attached 

The physical device unit specified in an IO.DET 
function was not attached by the issuing task. This 
code has no bearing on the attachment status of other 
tasks. 

End-of-file encountered 

An end-of-file control card was recognized. 


Illegal function 


A function code was specified in an I/O request that is 
illegal for card readers. 


Buffer allocation failure 


Dynamic storage space has been depleted, and there was 
insufficient buffer space available to allocate a card 
buffer (i.e., cards are read into a driver buffer 
translated and then moved to the user buffer). 
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Table 8-4 (Cont.) 
Card Reader Status Returns 


Code Reason 


IE.OFL Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration, 


IE.SPC Illegal address space 
The buffer specified for a read request was partially 


or totally outside the address space of the issuing 
task. Alternately, a byte count of zero was specified. 


8.5 FUNCTIONAL CAPABILITIES 
The card reader driver can perform the following functions: 

1. Read cards in DECO26 format and translate to ASCII. 

2e Read cards in DECO29 format and translate to ASCII. 

3. Read cards in binary format. 
If the QIO macro specifies the IO.RLB or IO.RVB function, the driver 
interprets all data as alphanumeric (026 or 029 format). As explained 
below, control characters indicate whether 026 or 029 is desired. 5 


the QIO macro specifies I0O.RDB, the driver interprets all data, 
including 026 and 029 control characters, as binarv. 


8.5.1 Control Characters 


Table 8-5 lists the multipunched cards that the card reader driver 
recognizes as control characters. They are never transferred to the 
user's buffer or included in the count of transferred bytes in 
alphanumeric mode. In binary mode the only control card recognized is 
binary EOF. 
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Table 8=5 
Card Reader Control Characters 


Punches Columns Meaning 
12-11-0-1-6-7-8-9 1 End-of-file (alphanumeric) 
12-11-0-1-6-7-8-9 (all 8 punches in End-of-file (binary) 

the first 8 columns) 
12-2-4-8 1 026~coded cards follow 
12-0-2-4-6-8 uh 029=coded cards follow 


DECO26 is the default translation mode when the system is 
bootstrapped. This mode remains in effect until explicitly changed by 
a control card indicating that DECO29 cards will follow. After 
encountering a DEC0O29 control card, the driver translates all cards in 
DECO29 format unless another DEC026 control card is encountered. This 
card overrides the 029 mode specification and indicates that 
subsequent cards are to be translated in 026 format. Control 
characters are addressed to the card reader itself, and remain in 
effect even when the reader is attached and subsequently detached, 


8.6 CARD READER DATA FORMATS 


The card reader reads data in either alphanumeric or binary format. 


8.6.1 Alphanumeric Format (026 and 029) 


Table 8=6 summarizes the translation from D=C026 or DEC029 card codes 
to ASCII. 
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Table 8-6 | 
Translation from DEC026 or DEC0O29 to ASCII 


Non- - Non- 
Parity Parity 
Character ASCII DECO29. DECO26 Character ASCII DECO29 DEC026 
173 12 0 12 0 ? 077 08 7 12 8 2 
175 11 0 11 0 @ 100 8 4 8 4 
SPACE 040 none none A 101 La i Oe 
! 041 12 87 1287 B 102 12 2 12 2 
" 042 8 7 085 Cc 103 12 3 12 3 
# 043 8 3 0 8 6 D 104 12 4 12 4 
$ 044 1183 118 3 E 105 12 5 12 5 
% 045 08 4 087 F 106 12 6 12 6 
AND 046 12 11 8 7 G 107 12 7 12 7 
047 8 5 8 6 H 110 12 8 12 8 
( 050 1285 08 4 tf 111 12 9 ‘12 :°9 
) 051 11 85 128 4 J 112 111 LL 2 
* 052 1184 118 4 K 113 11 2 11 2 
+ 053 12 86 12 L 114 il 3 11 3 
‘ 054 . 08 3 0 8 3 M 115 11 4 11 4 
- 055 11 11 N 116 11 5 Li'S 
° 056 12 8 3 12 8 3 O 117 ~ 11 6 ll 6 
/ 057 01 0.1 P 120 Li 7 LA: 7 
0 060 0 0 Q 121 11 8 11 8 
1 061 1 1 R 122 ll 9 11 9 
2 062 2 2 S 123 0 2 02 
3 063 3 3 ay 124 0 3 0 3 
4 064 4 4 U 125 0 4 0 4 
5 065 5 5 V 126 0 5 05 
6 066 6 6 W 127 0 6 0 6 
7 067 7 7 xX 130 07 07 
8 070 8 8 Y 131 0 8) 0 8 
9 071 9 9 Z 132 0 9 0 9 
: 072 8 2 -11 8 2 [ 133 1282 1185 
; 073 11 86 0O 8 2 \ 134 08 2 8 7 
< 074 1284 128 6 ] 135 1182 1285 
= 075 8 6 8 3 t OR 136 1187 85 
> 076 0 8 6 11 8 6 + or. - 137 08 5 8 2 


8.6.2 Binary Format 


In RSX-11M binary format, the data are not packed, but are transferred 
exactly as read, one card column per word. Because each word has 16 
bits and each card column represents only 12, the data from the column 
are stored in the rightmost 12 bits of the word. The word's remaining 
four bits contain zeros. 
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8.7 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the card reader driver described 
in this chapter. Section 8.4 contains information on operational 
error-recovery procedures which might be important from a programming 
point of view. 


8.7.1 Input Card Limitation 


Only one card can be read with a single QIO macro call. A request to 
read more than 80 bytes or columns, the length of a single card, does 
not result in a multiple card transfer. Only 80 columns are 
processed. It is possible to read fewer than 80 columns of card input 
with a QIO read function. The user can specify that only the first 10 
columns, for example, of each card are to be read. 


8.7.2 Aborting a Task 


If a task which is waiting for the card reader to be readied is 
aborted, the card reader driver recognizes this fact within one 
second. It is not necessary to ready the reader before aborting the 
task, as is the case for DECtapé. 
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CHAPTER 9 


MESSAGE-ORIENTED 
COMMUNICATION DRIVERS 


9.1 INTRODUCTION 


RSX-11M supports a variety of communication line interfaces - 
synchronous and asynchronous, single-line and multiplexers, 
character-oriented and message-oriented. These are used for terminal 
communications, remote job entry, multicomputer interfaces, and 
laboratory and industrial control communications. Communications line 
interfaces can be roughly divided into two categories: 


° Terminal (character-oriented) communications devices 
‘ Multicomputer (message-oriented) communications devices 


Chapter 2 describes the character-oriented asynchronous communications 
line interfaces used primarily for terminal communications. The 
PDP-11 PERIPHERALS HANDBOOK contains more detail on these devices. 
This chapter describes in some detail the RSX-11M message-oriented 
synchronous and asynchronous communication line interfaces. These are 
used most frequently in multicomputer communications. 


Character-oriented communications devices include the DH1l, DJll, 
DL11-A, DL11<-B, DL11-C, and DL11-D interfaces. These are asynchronous 
multiplexers and single-line interfaces which are used almost 
exclusively for terminal communications. Transfers on all of these 
interfaces are performed one character at a time. None of the 
interfaces in this category have drivers of their own (i.e., they are 
supported via the terminal driver), and none can be accessed directly 
as RSX-11M devices. 


Message-oriented communications line interfaces are used primarily to 
link two separate but complementary computer systems. One system must 
serve as the transmitting device and the other as the receiving 
device. Devices in this category include the synchronous and 
asynchronous single-line interfaces summarized in Table 9-1. 
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Table 9-1 
Message-Oriented Communication Interfaces 


Model Type Function 

DLL1-E Asynchronous Single-line interface 
DP11 Synchronous Single-line interface 
DU11 Synchronous Single-line interface 


The message-oriented communication line interfaces are used primarily 
to transfer large blocks of data. 


Whereas the character-oriented interfaces can only be accessed 
indirectly through the terminal driver, the DLI1-E, DP1ll, and DU11 
allow I/O requests to be queued directly for them. These devices have 
drivers of their own and can be accessed by means of the logical 
device names listed in Table 1-1. These names can be used in 
assigning LUNs via the ASSIGN LUN system directive, at task build or 
via the REASSIGN MCR. command. The following subsections briefly 
discuss the message-oriented interfaces supported for RSX-11M. 


9.1.1 DL11-E Asynchronous Line Interface 


The DL11-E is an asynchronous, serial-bit, single-line interface. It 
is a block-transfer device used for remote terminal and multicomputer 
communications. Baud rates are selectable between 50 and 9600, and 
full data set control is supported. A single PDP-1l can support as 
many as 16 DL11-E interfaces. 


9.1.2 DP11 Synchronous Line Interface 


The DP1ll provides a program interrupt interface between a PDP-1l1 and a 
serial synchronous line. This interface facilitates the use of the 
PDP-11 in remote batch processing, remote data collection, and remote 
concentration applications. The modem control feature allows the DP1ll 
to be used in switched or dedicated configurations. — 


On the DP1l, baud rates are selectable between 2000 and 19,200. The 
programmer can. select a specific sync character which is used to 
synchronize the transmitting and receiving systems. A single PDP-1l 
can support up to 16 DP1ll interfaces. 
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9.1.3 DU11 Synchronous Line Interface 


The DU11 synchronous line interface is a single-line communications 
device which provides a program-controlled interface between the 
PDP-11 and a serial synchronous line. The PDP-l1l can be interfaced 
with a high-speed line to perform remote batch processing, remote data 


-collection, and remote concentration applications. Modem control is a 


Standard feature of the DUll and allows the device to be used in 
switched or dedicated configurations. The DU1l transmits data at a 
maximum rate of 9600 baud; this rate is limited by modem and data set 
interface level converters. 


The DU11 can be programmed to accept any user-defined sync character. 
The use of the sync character is the same for the DU1l1 and the DPll. 
A single PDP-11l can support as many as 16 DUI11 interfaces. 


9.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the GET LUN INFORMATION system 
directive (the first characteristics word) contains the following 
information for message-oriented communication interfaces. A bit 
setting of 1 indicates that the described characteristic is true for 
the interfaces described in this chapter. 


Bit Setting Meaning 
0 0 ~Record-oriented device 
1 0 Carriage-control device 
2 0 Terminal device 
3 0 Directory device 
4 0 Single-directory device 
5 0 Sequential device 
6-12 0 Reserved 
13 1 Device mountable as a communications 
channel 
14 0 Device mountable as a FILES-11 volume 
15 1 Device mountable 


Words 3 and 4 are undefined, and word 5 has a special meaning for the 
DP1l and the DU1l1 interfaces. Byte 0 of word 5 contains the number of 
sync characters to be transmitted before a synching message (e.g., 
after line turn around in half duplex operation), and byte 1 is used 
as a syne counter. 
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9.3 QIO MACRO 


This section summarizes the standard and device-specific functions of 
the QIO macro that are valid for the communication interfaces 
described in this chapter. 


9.3.1 Standard QIO Functions 
Table 9-2 lists the standard functions of the QIO macro that are valid 
for the communication devices. 


Table 9=2 
Standard QIO Functions for Communication Interfaces 


Format Function 
QIOSC IO.ATT,... Not applicable (NOP) 
QIOSC IO.DET,... | Not applicable (NOP) 
QIOSC IO.KIL,... Not applicable (NOP) 
QIOScC I0.RLB,...,<stadd,size> Read logical block (stripping sync) 
QIOSC IO.WLB,...,<stadd,size> ee a block (preceded by 
syncs 


where: stadd is the starting address of the data buffer (may be on a 
byte boundary). 


size is the data buffer size in bytes (must be greater than 
Zero). 
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9.3.2 Device-Specific QIO Functions 


The specific functions of the QIO macro that are valid for the 
communication line interfaces are shown in Table 9-3, 


Table 9-3 
Device-Specific QIO Functions for Communication Interfaces 


Format . Function 

~QIO$C IO.HDX,... Set device to half-duplex mode 

QIOSC IO.INL,... Initialize device and set device 
characteristics 

QIOSC IO.RNS,...,<stadd,size> Read logical block, without 
stripping sync characters 
(transparent mode) 

QIOSC IO.SYN,...,<syn> Specify sync character 

QIOSC IO.TRM,... Terminate communication, 
disconnecting from physical channel 

QIOSC IO.WNS,...,<stadd,size> Write logical block without 
preceding sync characters 


(transparent mode) 


where: stadd is the starting address of the data buffer (may be on a 
byte boundary). 


size is the data buffer size in bytes (must be greater than 
Zero) . 


syn is the sync character, expressed as an octal value. 


The device-specific functions listed in Table 9-3 are described in 
greater detail below. 


9.3.2.1 IO.HDX -— The IO.HDX QIO function is used to set the mode on a 
DLI1-E, DP1l1, or DU11 unit to half-duplex. The IO.HDX function code 
can be combined (ORed together) with the IO.SYN function code, if 
desired, to set the operational characteristics of the physical device 


unit. 
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9.3.2.2 IO.INL and IO.TRM =- These two QIO functions have the same 
function code but different modifier bits. IO.INL is used to 
initialize a physical device unit for use as a communications link. 
It turns the device on-line, sets device characteristics, and ensures 
that the appropriate data terminal is ready. I0.TRM disconnects’ the 
device. If it is a dial-up interface, it also hangs up the line. 


9.3.2.3 IO.RNS - The IO.RNS QIO function is used to read a _ logical 
block of data, without stripping the sync characters which may precede 
the data. A similar function is IO.RLB, which is non-transparent, in 
that it causes syir.c claracters preceding the data message to be 
stripped. I0O.RLB is used at the start of a segmented data request, in 
which the block might have the following layout: | 


isisiuiulalulcs|es]| para cs 
123 456 7 8 


where: S is a sync character 
H is a header character 
CS is a validity check character 


The programmer must strip sync characters from the beginning of a data 
block in this way. Stripping only at the beginning of a read allows a 
later character which happens to have the same binary value as a_ sync 
character to be read without stripping. IO.RLB is used to read a 
logical block with leading sync characters stripped; IO.RNS is used 
to read the block without stripping leading sync characters. 
Generally, IO.RLB should be used. 


9.3.2.4 IO.SYN - This QIO function allows the programmer to _ specify 
the syne character to be recognized when an IO.RLB or IO.WLB function 
is performed. IO.SYN can be combined (ORed together) with IO.HDX to 
set the characteristics of the physical device unit. 


9.3.2.5 IO.WNS - This QIO function causes a logical block to be 
written with no preceding sync characters. To ensure that the two 
systems involved in a communication are synchronized, two or more sync 
characters are transmitted by one system and received by the other 
before any other message can be sent. IO.WLB is used to write a block 
of data, preceded by sync characters; IO.WNS is used to perform a 
block transfer without sending sync characters first. Generally, 
IO.WLB should be used. 
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9.4 STATUS RETURNS 
The error and status conditions listed in Table 9-4 are returned by 


the communication drivers described in this chapter. 


Table 9=4 
Communication Status Returns 


Code Reason 


IS.SUC Successful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
bytes processed, if the operation involved reading or 
writing. 


IS.PND I/O request pending 
The operation specified in the QIO directive has not 
yet been executed, The I/O status block is filled with 
zeros. 


IE.DNR Device not ready 
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f The physical device unit specified in the QIO directive 

: was not ready to perform the desired I/O operation. 
This code is returned to indicate one of the following 
conditions: 


FRETS 


e The physical device unit could not be initialized 
(i.e., the circuit could not be completed). 


« The transmission of a character was not followed by 
an interrupt within the period of time selected as 
the device timeout period. This timeout occurs only 

. when a transmission is in progress and the interrupt 
\ marking completion of a message does not occur, The 
appropriate response to this condition is to attempt 
to resynchronize the device by initializing and 
accepting the next request. A timeout does not occur 
on a read. If the receiving device is not ready, the 
transfer will not be initiated by the transmitting 
device. Once the transfer is initiated, however, it 
will complete either by satisfying the requested byte 
count or by timing out. 
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Table 9-4 (Cont.) 
Communication Status Returns 


Code Reason 


IE.IFC Illegal function 


A function code was specified in an I/O request that is 
illegal for message~oriented communication devices. 


IE.OFL Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration, 


IE.SPC Illegal address space 


The buffer specified for a read or write request was 
partially or totally outside the address space of the 
issuing task. Alternately, a byte count of zero was 
specified. 


9.5 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the message-oriented communication 
interfaces described in this chapter. 


9.5.1 Transmission Validation 


Because there is no way for the transmitting device to verify that the 
data block has successfully arrived at the receiving device unless the 
receiver responds, the transmitter assumes that any message which is 
clocked out on the line (without line or device outage) has been 
successfully transmitted. As soon as the receiver is able to satisfy 
a read request, it returns a successful status code (IS.SUC) in the 
I/O status block. Of course, only the task which receives the message 
can determine whether or not the message has actually been transmitted 
accurately. 


The receiving device should be ready to receive data (with a read 
request) at the time the transmission is sent. 
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9.5.2 Redundancy Checking 


By the nature of message-oriented communications, only the task which 
receives a communication can determine whether or not the message was 
received successfully. The transmitter simply transfers data, without 
validation of any kind. It is therefore the responsibility of the 
communicating tasks which use the device to check the accuracy of the 
transmission. A simple validity check is a checksum-type longitudinal 
redundancy check. A better approach to validating data is the use of 
a cyclic redundancy check (CRC). A CRC can be computed in software or 
with a hardware device, such as the KG-1l1l communications arithmetic 
option. 


9.5.3 Half-Duplex Considerations 


Only half-duplex mode is supported for the message-oriented 
communication interfaces described in this chapter. A unit must be 
explicitly declared half-duplex by setting the mode with an IO.HDX QIO 
function. Because there is a single I/O request queue, only one QIO 
request can be performed at a time. It is therefore not possible, 
through QIOs, for a device to send and receive data at the same time. 


9.5.4 Low-Traffic Sync Character Considerations 


If message traffic on a line is low, each message sent from a 
communications device should be preceded by a sync train. This 
enables the controller to resynchronize if a message is "“broken" 
(i.e., part or all of it is lost in transmission). Correspondingly, 
every message received by a communications device under low-traffic 
conditions, when messages are not contiguous (back-to-back), should be 
read via an IO.RLB (read, strip sync) function. This requires that 
the first character in the data message itself not have the binary 
value of the sync character. 


9.5.5 Vertical Parity Support 


Vertical parity is not supported by the DLI11-E, DP1l, and DU11. Codes 
are assumed to be eight-bit only. 
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9.5.6 Importance of IO.INL 


After the type of communication line has been determined, and after 
IO.SYN has specified the sync character, it is extremely important 
that IO.INL be issued before any transfers occur. This. ensures that 
appropriate parameters are initialized and that the interface is 
properly conditioned. Note that IO.INL provides the only means of 
setting device characteristics, such as sync character. For this 
reason, I0.INL should always be used immediately prior to the first 
transfer over a newly-activated link. 


9.6 PROGRAMMING EXAMPLE 


The following example illustrates the initialization, setting of 
device parameters, and transmission of a block of data on a 
message~oriented communication device. 


~MCALL ALUNS$S,QIOSS 


ALUNSS #1,#"XP,#0 

QIO$S #IO.HDX!IO.SYN,#1,,,,,<#226> 
QIo$ss #I0O.INL,#1 | 

QIOSS #IO.WLB,#1,,,#TXSTS,#TXAST ,<#TXBUF,#100>; SEND A BLOCK 
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BEQ 10$ 
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USE LUN1 FOR DP11 
SET DEVICE PARAMETERS 
PUT DEVICE ON LINE 


WAS DATA CLOCKED OUT 
SUCCESSFULLY? 
IF SO, SET UP FOR NEXT 
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ANALOG~TO=-DIGITAL CONVERTER DRIVERS 


10.1 INTRODUCTION 


The AFC1l1 and ADO1=-D analog-to-digital (A/D) converters are used for 
the acquisition of industrial and laboratory analog data. Although 
each has its own driver, programming for both is quite similar and 
both are multichannel, programmable gain devices. The AD01=-D should 
not be confused with the ADUO1, a UDC module, which is described in 
Chapter ll. Table 10-1 compares the AFC1l1 and the ADO1-D briefly, and 
subsequent sections describe these devices in greater detail. 


Table 10-1 
Standard Analog-to-Digital Converters. 


AFC1l ADO1=-D 
Maximum sampling rate (points 200 (20 per single) Approximately 
per second) channel 10,000 
Number of bits 13 or 14 10 or ll 
Maximum number of analog channels 1024 64 | 


that can be multiplexed 


10.1.1 AFC11 Analog-to-Digital Converter 


“The AFCl1 is a differential analog input subsystem for industrial 
data~acquisition and control systems. It multiplexes signals, selects 
gain, and performs a 13- or 14-bit analog-to-digital conversion under 
program control. With the use of appropriate signal-conditioning 


modules, the system can intermix ind accept low-level, high-level, and 


current inputs, with a high degree of noise immunity. 
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10.1.2 ADO1=-D Analog-to-Digital Converter 


The ADO01=-D is an extremely fast analog data-acquisition system. It 
multiplexes signals, selects gain, and performs a 10- or ll-bit 
analog-to-digital conversion under program control. The ADO1=-D is 
normally unipolar, but an optional sign-bit facilitates bipolar 
operation. 


10.2 GET LUN INFORMATION MACRO 


If a GET LUN INFORMATION system directive is issued for a LUN 
associated with an analog-to-digital converter, word 2 (the first 
characteristics word) contains all zeros, words 3 and 4 are undefined, 
and word 5 is not significant, since there is no concept of a default 
buffer size for analog-to-digital converters. 


10.3  QIO MACRO 


This section summarizes standard and device-specific QIO functions for 
analog-to-digital converters. 


10.3.1 Standard QIO Function / 
K 

The standard function that is valid for analog-to-digital converters 

is shown in Table 10-2. 

Table 10-2 
Standard QIO Function for the A/D Converters 
Format Function 
QIOSC IO.KIL,... Cancel I/O requests ( 


Since all requests are processed with a small amount of time, no in 
progress request is ever canceled. This function simply cancels all 
queued requests, 


10.3.2 Device-Specific QIO Function 


The device-specific function of the QIO macro that is valid for 
analog-to-digital converters is shown in Table 10-3. ‘ 
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Table 10-3 


Device-Specific QIO Function for the A/D Converters 


Format 


QIO$C IO.RBC,...,<stadd,size,stcnta> 


wheres: 


Bits 
0-11 
12-15 


Function 


Initiate multiple A/D 
conversions 


5 SS SS RRA MBSA EH SPR SI SRLS ETE BESSA SB ERE PLIERS ARE EIG ATES SDE ERLSEEEE EERE AENEID AL YECEEE DENS ATL MEER ED PATEL TEED PILE ALE 


stadd is the starting address of the data buffer (must be on 
a word boundary). 
size is the control buffer size in bytes (must be even and 
greater than zero); the data buffer is the same size. 
stcnta is the starting address of the control buffer (must be 
on a word boundary); each control buffer word must be 
constructed as shown in Table 10-4. 
Table 10-4 
A/D Conversion Control Word 
Meaning AFCL1 ADO1=D 
Channel number Ranges 0-1023 Range: 0-63 
Gain value for this Gains Gain: 
sample, expressed as 
a bit pattern as 
follows 
5. 4 13: 
0 0 0 0 1 1 
0 0 0 1 2 2 
0 0 A, 0 illegal 4 
0 0 1 1 illegal 8 
0 1 0 0 10 illegal 
0 1 0 1 20 illegal 
0 1 1 0 illegal illegal 
0 L 1 1 illegal illegal 
x 0 0 0 50 illegal 
1 0 0 1 100 illegal 
1 0 1 0 illegal illegal 
1 0 1 1 illegal illegal 
ai 1 0 0 200 illegal 
1 1 0 1 1000 illegal 
1 1 1 0 illegal illegal 
1 A. ud 1 illegal illegal 
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10.4 FORTRAN INTERFACE 


A collection of FORTRAN-callable subroutines provide FORTRAN programs 
access to the AFCl1l and the ADO1-D. These are described in this 
section. All are reentrant and may be placed in a resident library. 


10.4.1 Synchronous and Asynchronous Process Control I/O 


The ISA standard provides for synchronous and asynchronous I/0. 
Synchronous I/O is indicated by appending a "W" to the name of the 
subroutine (e.g., AISQ/AISQW). The synchronous call suspends’ task 
execution until the I/O operation is complete. If the asynchronous 
form is used, execution continues and the calling program must 
periodically test the status word for completion. 


10.4.2 The isb Status Array 


The isb (I/O status block) parameter is a two-word integer array that 
contains the status of the FORTRAN call, in accordance with ISA 
convention. This array serves two purposes: 


l. It is the 2-word I/O status block to which the driver returns 
an I/O status code on completion of an I/O operation, 


2. The first word of isb receives a status code from the FORTRAN 
interface in ISA-compatible format, with the exception of the 
I/O pending condition, which is indicated by a status of 
zero. The ISA standard code for this condition is +2. 


The meaning of the contents of isb varies, depending on the FORTRAN 
call that has been executed, but Table 10-5 lists certain general 
principles that apply. The section describing each subroutine 
provides further details. 
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Table 10-5 
Contents of First Word of isb 


Contents Meaning 

isb(1) = 0 Operation pending; I/O in progress 

isb(1) =1 Successful completion 

isb(1) = 3 Interface subroutine unable to generate 
QIO directive or number of samples is 
zZexo 

3 < isb(1) < 300 QIO directive rejected and actual error 
code = -(isb(1) - 3) 

isb(1) > 300 . Driver rejected request and actual error 


code = -(isb(1) = 300) 


Unless otherwise specified, the value of isb(2) is the value returned 
by the driver to the second word of the I/O status block. 


FORTRAN interface subroutines depend on asynchronous system traps to 


set their status. Thus, if the trap mechanism is disabled, proper 


status cannot be set. 


10.4.3 FORTRAN Subroutine Summary 
Table 10-6 lists the FORTRAN interface subroutines supported for the 
AFC11l and ADO1=-D under RSX-11M,. 


Table 10-6 
FORTRAN Interface Subroutines for the AFCl11 and AD0O1=D 


Subroutine Function 

AIRD/AIRDW Perform input of analog data in random 
sequence 

AISQ/AISQW Read a series of sequential analog input 
channels 

ASADLN Assign a LUN to ADO: 

ASAFLN Assign a LUN to AFO: 
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The following subsections briefly describe the function and format of 
each FORTRAN subroutine call. Note the use of ASADLN and ASAFLN to 
assign a default logical unit number. 


10.4.4 AIRD/AIRDW: Performing Input of Analog Data in Random 


sequence 


The ISA standard AIRD/AIRDW FORTRAN subroutines input analog data in 
random sequence, These calls are issued as follows: 


AIRD 
CALL (inm,icont,idata, [isb], [lun]) 
ATRDW 
where: inm specifies the number of analog input channels, 


icont is an integer array containing terminal connection 
data - channel number (right-justified in bits 0-11) 
and gain (bits 12-15), as shown in Table 10-4, 


idata is an integer array to receive the converted values. 


isb is a two-word integer array to which the subroutine 
status is returned 


lun is the logical unit number. 


The isb array has the standard meaning defined in section 10.4.2. If 
inm = 0, then isb(1) = 3. The contents of idata are undefined if an 


error occurs. 


10.4.5 AISQ/AISQW: Reading Sequential Analog Input Channels 


The ISA standard AISQ/AISQW FORTRAN subroutines read aie series _of 
sequential analog input channels. These calls are issued as follows: 


AISQ 
CALL (inm,icont,idata, [isb], [lun] ) 
AISQW 
where: inm specifies the number of analog input channels. 


icont is an integer array containing terminal connection 
data - channel number (right-justified in bits 0-11) 
and gain (bits 12-15), as shown in Table 10-4, 

idata is an integer array to receive the converted values. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number. 
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For sequential analog input, channel number is computed in steps of 
one, beginning with the value specified in the first element of icont. 
The channel number field is ignored in all other elements of the 
array. : 


The gain used for each conversion is taken from the respective element 
in icont. Thus, even though the channel number is ignored in all but 
the first element of icont, the gain must be specified for each 
conversion to be performed. 


The isb array has the standard meaning defined in section 10.4.2. If 
inm = 0, then isb(1) = 3. The contents of idata are undefined if an 
error occurs, 


10.4.6 ASADLN: Assigning a LUN to ADO: 


The ASADLN FORTRAN subroutine assigns the specified LUN to ADO: and 
defines it as the default logical unit number to be used whenever a 
LUN specification is omitted from an AIRD(W)/AISQ(W) subroutine call. 
It is issued as follows: 


CALL ASADLN (lun, [isw]) 
where: lun is the logical unit number to be assigned to ADO: and 
defined as the default unit. 
isw is an integer variable to which the result of the 


ASSIGN LUN system directive is returned. 


Only the LUN specified in the last call to ASADLN or ASAFLN is defined 
as the default unit. 


10.4.7 ASAFLN: Assigning a LUN to AFO: 

The ASAFLN FORTRAN subroutine assigns the specified LUN to AFO: and 
defines it as the default logical unit number to be used whenever a 
LUN specification is omitted from an AIRD(W)/AISQ(W) subroutine call. 
It is issued as follows:. 


CALL ASAFLN (lun, [isw]) 
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where: lun 


isw 


is the logical unit number to be assigned to AFO: and 
defined as the default unit. 


is an integer variable to which the status from the 
ASSIGN LUN system directive is returned. 


Only the LUN specified in the last call to ASAFLN or ASADLN is defined 
as the default unit. 


10.5 STATUS RETURNS - 


The error and status conditions listed in Table 10-7 are returned by 
the analog-to-digital converter drivers described in this chapter. 


Code 


IS.SUC 


IS.PND 


IE.ABO 


IF. BAD 


Table 10-7 
A/D Converter Status Returns. 
Reason 


Successful completion 


The operation specified in the QIO directive was 


completed successfully. The second word of the I/O 


status block can be examined to determine the number of 
A/D conversions performed, 


I/O request pending 


The operation specified in the QIO directive has not 
yet been executed. The I/O status block is filled with 


Zeros. 
Operation aborted 


The specified I/O operation was cancelled via I0.KIL 
while still in the I/O queue. 


Bad parameter 


An illegal specification was supplied for one or more 
of the device-dependent QIO parameters (words 6-11). 
For the analog-to-digital converters, this code 
indicates that a bad channel number or gain code wis 
specified in the control buffer. 
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Table 10-7 (Cont.) 
A/D Converted Status Returns 


Code Reason 
IE.BYT Byte~aligned buffer specified 


Byte alignment was specified for a data or control 
buffer, but only word alignment is legal for 
analog-to-digital convertors. Alternately, the length 
of the data and control buffer is not an even number of 
bytes. 


ITE.DNR Device not ready 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
For the AFCll1, this code is returned if an interrupt 
timeout occurred or the power failed. In the case of 
the AD01=-D, which is not operated in interrupt mode, 
this code indicates a software timeout occurred (i.e. 
a conversion did not complete within 30 microseconds). 


IE.IFC Illegal function 


A function code was specified in an I/0 request that is 
illegal for analog-to-digital convertors. 


TE.OFL Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


IE.SPC Tllegal address space 


The data or control buffer specified for a conversion 
request was partially or totally outside the address 
space of the issuing task. Alternately, a byte count 
of zero was specified, : 


FORTRAN interface values for these subroutines are presented in 
section 10.5.1. 
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10.5.1 FORTRAN Interface Values 
The values listed in Table 10-8 are returned in FORTRAN subroutine 
calls. 


Table 10-8 
FORTRAN Interface Values 


Status Return FORTRAN Value . 
IS.SUC +01 
IS.PND +00 
IE. ABO +315 
IE.ADP +101 
IE.BAD +301 
IE.BYT +319 
IE.DAO +313 
IE.DNR +303 
IE.IEF +100 
IR.IFC +302 
IE. ILU +99 
IE.NOD +323 
IE.ONP +305 
IE.PRI +316 
IE. RSU +317 
IE.SDP +102 
IE.SPC +306 
IE. ULN +08 
IE.UPN +04 


10.6 FUNCTIONAL CAPABILITIES 


The AFC1ll and ADO1=D operate only in multi-sample mode, because the 
user can simulate single~sample mode by simply specifving one sample. 
Multi-sample mode permits many channels to be sampled at approximately 
the same time without requiring the user to queue multiple I/O 
requests. 


The maximum number of channels in the configuration is specified at 
system-generation time. This value is stored in the respective AFC1l 
and AD01=-{D unit control blocks, 


19.6.1 Control and Data Buffers 


The user must define two buffers of equal size, the control buffer and 
the data buffer. The former contains the control words needed to 
perform one A/D conversion per channel specified. Each control word 
indicates the channel to be sampled and the gain to be applied (see 
Table 10-4). 
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The data buffer receives the results of the conversions. Each result 
is placed in the data buffer location that corresponds to the control 


word that specified it. 


10.7 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the analog-to-digital converter 
drivers described in this chapter. 


10.7.1 Use of A/D Gain Ranges 


Note that the A/D gain ranges overlap. The key to successful use of 
the A/D converters is to change to a higher gain whenever a full-scale 
reading is imminent and to change to a lower gain whenever the last 
A/D value recorded was less than half of full scale. This method 
maintains maximum resolution while avoiding saturation. 


10.7.2 Identical Channel Numbers on the AFC11 


When requesting sampling of more than one channel, the user should not 
specify multiple sampling of a single channel without 10 or more 
intervening samples on other channels. This ensures 50 milliseconds 
between samples on a single channel. If sampling occurs more often 
than this on a single channel, partial results are returned (see 
10.7.3 below). 


10.7.3 AFC11 Sampling Rate 


Although the AFC11 can sample a maximum of 200 points per second, a 
single channel can only be sampled at 20 points per second. Because 
the channel capacitor needs 50 milliseconds to recharge after each 
conversion, more frequent sampling may result in partial readings. If 
this occurs, the user will receive no indication that information is 
being lost. To ensure that information is not lost on any one 
channel, the user should sample approximately ten other channels 
before returning to the first one. 


10.7.4 Restricting the Number of ADO1-D Conversions 


The ADO1-D is an extremely fast device, providing a 25=-microsecond 


conversion rate, and is dxiven programmably to minimize system 
overhead. However, an excessive number of conversions in a_e single 
request essentially locks out the rest of the system because the 
driver does not return control to the system until it has finished all 
the specified conversions. No other task can run, although interrupts 


can still occur and are processed. 
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UNIVERSAL DIGITAL CONTROLLER DRIVER 


11.1 INTRONUCTION 


The UDC1l1l is a digital input/output system for industrial and process 
control applications. It interrogates and/or drives up to 252 
directly addressable digital sense and/or control modules. The UDC11 


operates under program control as a high-level digital multiplexer, . 


interrogating digital inputs and driving digital outputs. 


While performing analog-to-digital conversions, the UDCll driver can 
handle other functions, such as contact or timer interrupts or 
latching output. These functions are performed immediately, without 
requiring any in progress analog-to-digital conversions to first be 
completed, . 


Unlike other RSX-11M I/O device drivers, the UDCll driver is neither a 
multicontroller nor a multiunit driver. 


ll.1.1 Creating the UDC11l Driver 


Since different installations have different configurations of 
modules, no preassembled driver is supplied with the RSX-11M systen. 
Each installation must assemble the driver source module with a prefix 
file that defines the particular hardware configuration. 


The prefix file is, created at system generation according to the 
user's response to questions relating to the UDC1ll. This file is 
named RSXMC.MAC and includes symbolic definitions of the UDCI11 
configuration. These definitions encode the relative module number 
and the number of modules for each generic type specified in the 
system generation dialog. The encoding has the following format: 


One or more of the following symbols is generated: 
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Symbol Module Type 

USSADM Analog input 

USSAOM Analog output 

US$CIM Contact interrupt ; 
USSCSM Contact sense input 
US$LTM Latching digital output 
US$SSM Single-shot digital output 
USSTIM Timer (I/O counter) 


Note that all modules of a given type must be installed together in 
sequential slots. . 


11.1.2 Accessing UDCl1l Modules 
RSX=11M provides two methods of accessing the UDC11: 
1. A QIO macro call issued to the driver 


2. Restricted direct access by any task to I/O page registers 
dedicated to the UDC11l 


The first method, access through the driver, is required to service 
interrupting modules and to set and record the state of latching 
digital output modules. 
The second method, direct access, is a high-speed, low-overhead way to 
service noninterrupting modules. The following functions may be 
performed: ~ 

» Analog output 

e Contact sense input 

e Single-shot digital output 


- Read a contact interrupt module 


- Read a timer module 


11.1.2.1 Driver Services - The driver services the following types of 
modules : ; 


1. Contact interrupt 
2. Timer (I/O counter) 
3. Analog input 


4. lLatching digital output 
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Contact and timer interrupts need not be serviced by a single task. 
One task may be connected to contact interrupts, and another to timer 
interrupts. A nonprivileged task can connect to either or both of 
these classes by providing a circular buffer to receive interrupt 
information and an event flag to allow triggering of the task whenever 
a buffer entry is made. 


11.1.2.2 Direct Access - A global common block within the I/0 page 
provides restricted direct access to the UDC1ll device registers. Ina 
Mapped system, the length of the block is set to prevent access to 
other device registers. In an unmapped system, the use of the common 
block is optional. Section 11.4 explains direct access more fully. 


11.2 GET LUN INFORMATION MACRO 


If a GET LUN INFORMATION svstem directive is issued for a LUN 
associated with the UDCll, word 2 (the first characteristics word) 
contains all zeros, words 3 and 4 are undefined, and word 5 is not 
significant, since there is no concept of a default buffer size for 
universal digital controllers. 


11.3 QIO MACRO 


This section summarizes standard and device-specific QIO functions for 
the UDCll driver. In issuing them, note the numbering conventions 
described in 11.7.2. 


11.3.1 Standard QIO Function 
The standard function that is valid for the UDC1ll is shown in Table 
lll. 


Table 1ll-1 
Standard QIO Function for the UDC11 


Format Function 
-QIOSC IO.KIL,... cancel I/O requests 


IO.KIL cancels all queued requests and disconnects all interrupt 
connections, but does not stop any I/O that is currently in progress. 
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11.3.2 Device-Specific QIO Functions 


UNIVERSAL DIGITAL CONTROLLER DRIVER 


Table 11-2 summarizes device-specific QIO functions that are supported 
for the UDCIll. 


QIO$C 
QTOSC 
QIO$sc 
QTOSc 


QIO$sc 


QIOSC 


Format 


IO.CCI,.. 


IO.CTI,.. 


I0.DCI,. e 


IO.DTI yee 


IO.ITI,.. 


IO.MLO, ee 


Table 11-2 
Device-Specific QIO Functions for the UDC11 


e,<stadd,sizb,tevf> 
.,<stadd,sizb,tevf,arv> 


-,<mn,ic> 


- ,<Opn ,pp,dp> 


QIO$C IO.RBC,...,<stadd,size,stcnta> 


where : 


stadd 


sizb 


tevf 


arv 


PP 


is the starting address 
a word boundary). 


is the data buffer size 
large enough to include 
data entry; the buffer 


Function 


Connect a buffer to contact 
interrupts 


Connect a buffer to timer 
interrupts 


Disconnect a buffer from 
contact interrupts 


Disconnect a buffer from timer 
interrupts 


Initialize a timer 


Open or close latching digital 
output points 


Initiate multiple A/D 
conversions 


of the data buffer (must be on 
in bytes (must be even and 


a 2-word buffer header plus one 
may cross a 4K boundary). 


is the trigger event flag number (in range 1 through 


64). 


is the starting address 


of the table of initial/reset 


values (must be on a word boundary). 


is the module number. 
is the initial count, 


is the first latching 


digital output point number, 


which must be on a module boundary (evenly divisible by 


16). 


is the 16<bit mask. 
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dp is the data pattern. 


size is the control buffer size in bytes (must be even and 
greater than zero); the data buffer is the same size. 


stcnta is the starting address of the control buffer (must be 
on a word boundary); each control buffer word must be 
constructed as shown in Table 11-3. 
The following sections describe the functions listed in Table 11-2. 


Table 11-3 
A/D Conversion Control Word 


Bits Meaning ADUO1] 
O-ll Channel number Range: 0=-1023 
12-15 Gain value for this Gains: 


sample, expressed as 
a bit pattern as 


follows 

15 14 13 12 
0 0 0 0 1 
0 0 0 1 2 
0 0 1 0 illegal 
0 0 Ll 1 illegal 
0 lL 0 0 10 
0 1 0 1 20 
0 1 1 0 illegal 
0 1 1 1 illegal 
1 0 0 0 50 
1 0 0 1 100 
1 0 1 0 illegal 
1 0 1 1 illegal 
1 a8 0 0 200 
1 l 0 1 1000 
1 1 1 0 illegal 
1 1 lL 1 illegal 


11.3.2.1 Contact Interrupt Digital Input (W733 Modules) - Digital 


input and change of state information from contact interrupt modules 
is reported in a requester-provided circular buffer. The buffer 
consists of a 2=<word header, followed by a data area in the following 


format : 
» [Beiver tose 
2 [ser fade 
seer 
[eer 
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Whenever a change of state occurs in one or more contact points an 
interrupt is generated. The UDC1l driver gains control, determines 
whether the change of state is of interest (i.e., a contact closure 
and point closing (PCL) is set on the module), and then optionally 
makes an entry in the data area of the buffer, updates the index words 
and -sets the trigger event flag of the connected task. 


Each entry consists of five words in the following format: 


Word Contents 
0 Entry existence indicator 
1 Change of state (COS) indicator 


Module data (current point values) 
3 Module number (interrupting module) 
4 Generic code (interrupting module) 


The driver enters data in the location currently indicated by the 
driver index. This pointer can be considered as a FORTRAN index into 
the buffer, i.e., the first location of the buffer is associated with 
the index 1. The beginning of the data area is the location of the 
first entry (index 3). Entries are made in a circular fashion, 
starting at the beginning of the data area, filling in order of 
increasing memory address to the end of the data area, and then 
wrapping around from the end to the beginning of the data area. If, 
near the end of the data area, only part of the entry (e.g., the first 
two words) can fit, the remainder (the other three) is placed at the 
beginning of the data area. 


It is expected that the connected task will maintain its own pointer 
(the user index) to the location in the buffer where it is next to 
retrieve contact interrupt data. When a task is triggered by the 
driver, it should process data in the buffer starting at the location 
indicated by its pointer and continuing in a circular fashion until 
the two pointers are equal or a zero entry existence indicator is 
encountered. Equality of pointers means that the connected task has 
retrieved all the contact interrupt information that the driver has 
entered into the buffer. 


The entry existence indicator is set nonzero when a buffer entry is 
made, When a requester has removed or processed an entry, he must 
clear the existence indicator in order to free the buffer entry 
position. 


If data input occurs in a burst sufficient to overrun the buffer, data 
are discarded and a count of data overruns is incremented. The 
nonzero entry existence indicator also serves as an overrun indicator. 
A positive value (+1) indicates no overruns between entries; a 
negative value is the two's complement of the number of times data 
have been discarded between entries. 
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The module number indicates a module on which a change of state in the 
direction of interest has been recognized for one or more discrete 
points. The direction of the change may be from 0 tol or 1 to 0O, 
depending on the PCL (point closing) and POP (point opening) module 
jumpers. The change of state (COS) indicator specifies which point or 
points of the module have changed state. 


The bit position of an on-bit in the COS indicator provides the 
low-order bits (3-0) of a point number and the module number provides 
the high order bits (15-4). The module data indicates the logical 
value (polarity) of each point in the module at the time of the 
interrupt. 


Contact interrupt data can be reported to only one _ task. The 
functions I0.CCI and I0.DCI in Table 11-2 are provided to enable a 
task to connect and disconnect from contact interrupts. If the 
connection is successful, the second word of the I/O status block 
contains the number of words passed per interrupt in the low-order 
byte and the initial FORTRAN index to the beginning of the data area 
in the high-order byte. 


11.3.2.2 Timer (W734 I/O Counter Modules) - A timer (I/O counter) 


module is a clock that is initialized (loaded), counts up or down, and 
then causes an interrupt. The UDC11 driver treats such modules in a 
way Similar to that in which it handles contact interrupts. The 
requester provides a circular buffer similar to that for contact 
interrupts. Each entry consists of four words in the following 
format : 


Word Contents 
0 . Entry existence indicator 
1 Module data (current value) 
2 Module number (interrupting module) 
3 Generic code (interrupting module) 


The IO.CTI function in Table 11-2 enables a task to connect to timer 
interrupts. The table of initial/reset values is used to initially 
load the timers and to reload them on interrupt (overflow). The table 
contains one word for each timer module. The contents of the first 
word is used to load the first module, and so forth. If a timer has a 
nonzero value when it interrupts, it is not reloaded, so that 
self-clocking modules and modules that interrupt on half count can 
continue counting from the initial value. 


The IO.DTI function in Table 11-2 disconnects a task from timer 
interrupts, and the I0.ITI function provides the capability to 
initialize a single timer. 
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11.3.2.3 lLatching Digital Output (M685 M803 and M805 
Modules) - Each module has 16 latching digital output points. The 
IO.MLO function in Table 11-2 opens or closes a set of up to 16 
points. Bit n of the mask and data pattern corresponds to the point 
opn +n. If a bit in the mask is set, the corresponding point is 
opened or closed, depending on whether the corresponding bit in the 
data pattern is clear or set. If a bit in the mask is clear, the 
corresponding point remains unaltered. 


11.3.2.4 Analog=-to-Digital Converter (ADU01 Module) = Each ADUO1] 
module has eight analog input channels. The I0.RBC function in Table 
11-2 initiates A/D conversions on multiple ADUO1 input channels. 
Restrictions on maximum sampling rates are the same as defined for the 
AFC11 in Chapter 10. 


11.4 DIRECT ACCESS 


Section 11.1.2 describes UDCl1 functions that may be performed by 
referencing a module through its physical address in the I/O page. 
Under RSX-11M such access is accomplished by one. of the following 
methods : 


l. A privileged task or any task running in an unmapped system 
has unrestricted access to the I/O page and may therefore 
access each module by absolute address. . 


2. Using the Task Builder, a task may link to a global common 
area whose physical address limits span a set of locations in 
the I/O page. This method applies to either a mapped or 
unmapped system. 


The latter method allows a task to be transported to any other system 
simply by relinking. Further, in a mapped system the memory 
management hardware will abort all references to device registers 
outside the physical address limits of the common block. 


The operations required to implement each method may be summarized as 
follows: 


l. Unrestricted access to the I/O page 
a. An object module is created which defines the UDC11 
configuration through a list of absolute global addresses 
and addressing limits for each module type. 
b. The object module is included in the system library file. 
c. A task is created containing the appropriate global 


references. Such references are resolved when the task 
builder automatically searches the system library file. 
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Steps a and b are executed once. Step c is performed each time a task 
is created that references the UDC1I1. ; 


2. Access to the I/O page through a Global Common Block: 
ae An object module is created which defines the UDC11 
configuration through a list of relocatable global 
addresses and addressing limits for each module type. 


b. The object module is linked, using the Task Builder, to 
create an image of the Global Common block on disk. 


c. The INSTALL MCR command is used to make the Global Common 
Block resident in memory. 


d. Atask is created containing the appropriate global 
references, Such references are resolved by directing 
the Task Builder to link the Task to the common block, 


The following paragraphs describe each step in detail. 


11.4.1 Defining the UDCl11 Configuration 


The source module UDCOM.MAC*, when assembled with the proper prefix 
file, provides global definitions for the following parameters: 


- The starting address of each module type. 

e The highest point number within a given module type. 

- The highest module number within a given module type. 
The last two parameters are absolute quantities that may be used to 
prevent a task from referencing a module that is non-existent or out 
of limits. 
By means of conditional assembly the list of addresses may be created 
as absolute symbols defining locations in the I/O page or as symbols 


within a relocatable program section to be used when building and 
linking to the UDC11 Global Common area. 


11.4.1.1 Assembly Procedure for UDCOM.MAC - UDCOM.MAC is assembled 
with the RSX-11M configuration parameters contained in the file 
RSXMC,. MAC. 


To create relocatable module addresses either the parameter '‘US$DCM' 
or ‘'MSSMGE' must be defined. 'MSSMGE' will be included in RSXMC.MAC 


* This module resides on the RKO5 cartridge of the RSX-11M 
distribution bit labeled SOURCE MASTER. It is under UIC [11,10]. 
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if memory management was specified when the system was generated. If 
not, the user should edit the file to include the following 


definition: 
US$SSDCM=0 

The file mav then be assembled using the MCR command: 
>MAC UDCOM,UDLST= [11,10] RSXMC,UDCOM 


This command invokes the MACRO-1l1 assembler which processes the input 
files RSXMC.MAC and UDCOM,.MAC to create UDCOM.OBJ and UDLST.LST. 


To create absolute module addresses, both of the above parameters must 
be undefined. Edit RSXMC.MAC, if necessary, to remove definitions and 
then invoke the MACRO=-11 assembler with the following MCR command: 


>MAC UDCDF, UDLST=[11,10]RSXMC ,UDCOM 


In this sequence the files UDCDF.OBJ and UDLST.LST are created from 
the specified source modules. UDCDF.OBJ contains the module addresses 


in absolute form. 


11.4.1.2 Symbols Defined by UDCOM.MAC =- This section lists the 


symbolic definitions created by UDCOM.MAC. 


The following symbols define the absolute or relocatable address of 
the first module of a given type: 


Symbol Module Type 

$.ADM Analog input 

$.AOM Analog output 

$.CIM Contact interrupt 

$.CSM Contact sense input 

$,.LTM Latching digital output 
$.SSM Single-shot digital output 
$.TIM Timer (I/O counter) 
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The addresses in relocatable form are defined in a program section 
named *UDCOM' having the attributes: 


REL - relocatable 
OVR = overlaid 

I - instruction 
GBL = global scope 


Note that these attributes correspond to those attached to a named 
common block within a Fortran program. 


In either the absolute or relocatable case, individual modules are 
referenced by the corresponding symbolic address plus a relative 
module index. 


The following symbols define the highest digital point within a module 
type: 


Symbol Module Type 

P$.CIM Contact interrupt 

P$.CSM Contact sense input 
P$.LTM Latching digital output 
P$.SSM Single—shot digital output 


The highest point number is defined relative to the first point on the 
first module of a specific type. 


For example if two contact interrupt modules are installed, the symbol 
"PS.CIM' will have an octal value of 37, 


The following symbols define the highest module number within a given 
module type. 


Symbol Module Type 

M$, ADM Analog input 

M$.AOM . Analog output 

MS$.CIM Contact interrupt 

MS$.CSM Contact sense input 
MS.LTM Latching digital output 
MS$.SSM Single-shot digital output 
M$.TIM Timer (I/O counter) 


The highest module number is defined relative to the first module of a 
given type. Thus, based on the previous example, M$.CIM will have a 
value of l. 
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11.4.2 Including UDCll Symbolic Definitions in the System Object 
Module Library 


As described in 11.4, a task having unrestricted access to the I/O 
page may reference a UDC11 module by absolute address. The object 
module UDCDF contains symbolic definitions of absolute module 
addresses and may be included in the System Object Module Library: 


SY: [1,1]SYSLIB.OLB 


The Task Builder automatically searches this file to resolve any 
undefined globals remaining after all input files have been processed, 


The following example illustrates the procedure for including the file 
‘UDCDF.OBJ' in the library. 


SET /UIC=[1,1] 
>LBR SYSLIB/IN=[200 ,200] UDCDF 


The SET MCR command is issued to establish the current UIC as _ [1,1]. 
Next, the RSX11M Librarian is invoked and instructed, through the use 
of the /IN switch to include the object module UDCDF.OBJ in the file 
SYSLIB.OLB. 


11.4.3 Referencing the UDCll through a Global Common Block 


The following sections define the procedure for creating a Global 
Common block in the I/O PAGE, making the block resident in memory, and 
creating a task which references UDC11 modules within the block. 
Examples are given for both mapped and unmapped systems. 


11.4.3.1 Creating a Global Common Block - The following sequence . 


illustrates the use of the object file UDCOM.OBJ to create a disk 
image of the global common area in a mapped svstem. 


>SET /UIC=[1,1] 

>TKB 
TKB>UDCOM/MM, LP: , SY: UDCOM/PI/-HD= [200 , 200] UDCOM 
TKB>/ 

ENTER OPTIONS: 

TKB>STACK=0 

TKB>/ 


In the above example, a current UIC of [1,1] is established and _ the 
Task Builder is initiated. The initial input line to the Task Builder 
specifies the following files: 

- A core image output file to be named UDCOM.TSK 


- A memory map output to the line printer 


11-12 


ae 


OIE STI 


Soe 


So: 


RETR AE DBRS BIE GAT TOR LT RTRSY RSET SRY ES TS GOCE ILE CERI ICSE SIE SE SNS 


CHAPTER 11. UNIVERSAL DIGITAL CONTROLLER DRIVER 


A symbol table file to be named UDCOM.STB 


All files reside on SY: under UIC [1,1]. The single input file, 
UDCOM.OBJ containing the UDCl1l address definitions as relocatable 
values, constitutes the input. 


The switches specified for the output files convey the following 
information to the Task Builder: 


/ MM indicates that the core image of the common block will 
reside on a system with Memory Management. 


/PIL indicates that the core image is position independent; 
that is the virtual address of the common block may 
appear on any 4K boundary within a task's address 
space, 


/-HD indicates that the core image will not contain a 
header. A header is only required for a core image 
file that is to be installed and executed as a task. 


A single line of option input must be entered to eliminate the default 
memory allocation for the stack area. 


The following sequence illustrates the corresponding procedure for an 
unmapped system: 


»SET /UIC=[1,1] 

>TKB 
TKB>UDCOM/-MM,LP: ,SY¥:UDCOM/PI /-HD= [200 , 200] UDCOM 
TKB>/ 

ENTER OPTIONS: 

TKB>S TACK=0 

TKB >PAR=UDCOM:171000:1000 

TKB>/ 


Again the task builder is requested to produce a core image and symbol 
table file under the UIC [1,1] and a map file on the line printer from 
the input file UDCOM.OBJ. The output file switches convey the 
following information: 


/-M™M indicates that the core image of the common block will 
reside on an unmapped system. 


/PI Indicates that the core image is position independent. 
In an unmapped system the core image is fixed in the 
same address space for all tasks; however, the global 
symbols defined in the symbol table file retain the 
relocatable attribute. 


/~HD indicates that a core image without a header is to be 
created. 
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The PAR option specifies the base and length of the common area _ to 
coincide with the standard UDC1l1 addresses in the I/O page. All 
references to the common block by tasks will be resolved within this 
region. 


11.4.3.2 Making the Common Block Resident - The following SET command 
creates a UDCII common biock residing in the I/O page for a mapped 


system: 
>SET /MALN=UDCOM:7710:10:DEV 

The corresponding command in an unmapped system is: 
>SET /MAIN=UDCOM:1710:10 :DEV 


The preceding sequence specifies the allocation of a common block in 
the I/O page whose physical address limits correspond to the UDC11 
standard locations. Note that the address bounds and length are 
defined in units of 32 words. 


11.4.3.3 Linking a Task to the UDC1ll1 Common Block - A task may access 
UDC11 modules by linking to the common block as follows: 


TKB>TASK ,LP:=TASK.OBJ 
TKB> / 

ENTER OPTIONS: 

>TKB COMMON=UDCOM: RW 
TKB>/ 


The above sequence is valid for either a mapped or unmapped system. 
In both cases the Task Builder will link the task to the common block 
by relocating the Global symbol definitions contained in UDCOM.STB. 
If memory management is present, the Executive will map the 
appropriate physical locations into the tasks virtual addressing space 
when the task is made active. 


11.5 FORTRAN INTERFACE 


A collection of FORTRAN-callable subroutines provide FORTRAN programs 
access to the UDC11. These are described in this section. All are 
reentrant and may be placed in a resident library. 


Instead of using the FORTRAN=-callable subroutines described in this 
section, a FORTRAN program may use the global common feature described 
in section 11.4 to reference UDC1ll modules directly in the I/0 page, 
as shown in the following example: 
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UDC11 GLOBAL COMMON 
COMMON /UDCOM/ ICSM(10) , IAO(10) 


READ CONTACT SENSE MODULE 1 DIRECTLY 


AAA ANA 


ICS=ICSM(1) 


Note that the position of each module type must correspond to the 
sequence in which storage is allocated in the common statements. 


11.5.1 Synchronous and Asynchronous Process Control 1/0 


The ISA standard provides for synchronous and asynchronous process 
I/o. Synchronous I/O is indicated by appending a "W" to the name of 
the subroutine (e.g., AO/AOW). But due to the fact that nearly all 
UDC1ll I/O operations are performed immediately, in most cases the "Ww" 
form of the call is retained only for compatibility and has no meaning 
under RSX-11M. In the case of A/D input, however, the "W" form is 
significant: the synchronous call suspends task execution until input 
is complete. If the asynchronous form is used, execution continues 
and the calling program must periodically test the status word for 


completion. 


11.5.2 The isb Status Array 


The isb (I/O status block) parameter is a 2-word integer array that 
contains the status of the FORTRAN call, in accordance with ISA 


convention. This array serves two purposes: 


l. It is the 2<word I/O status block to which the driver 
returns an I/O status code on completion of an I/0 


operation. 


2. The first word of isb receives a status code from the 
FORTRAN interface in ISA-compatible format, with the 
exception of the I/O pending condition, which is 
indicated by a status of zero. The ISA standard code for 
this condition is +2, 


The meaning of the contents of isb varies, depending on the FORTRAN 
call that has been executed, but Table 11-4 lists certain general 
principles that apply. The section describing each subroutine gives 


more details. 
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Table 11-4 
Contents of First Word of isb 
Contents Meaning 
isb(1) = 0 Operation pending; I/O in progress 
isb(1) =1 Successful completion 
ish(1) = 3 Interface subroutine unable to 
generate QIO directive or number of 
points requested is zero 
3 ¢ isb(1) < 300 QIO directive rejected and actual 
error code = -(isb(1) = 3) 
isb(1) > 300 Driver rejected request and actual 


error code = <-(isb(1) - 300) 


In some cases, the values or states of points being read, pulsed, or 
latched are returned to isb word 2. 


FORTRAN interface subroutines depend on asynchronous system traps to 
set their status. Thus, if the trap mechanism is disabled, proper 
status cannot be set. i 


For direct access calls (indicated in Table 11-5 below), errors are 
detected and returned by the FORTRAN interface subroutine itself, 
rather than the driver. Although the use of a two-word status block 
is therefore unnecessary, these errors are returned in standard format 
to retain compatibility with RSX-11D. Errors of this type that may he 
returned are: 


ish(1) = 3 Number of points requested is 
zero 
isb(1) = value of IE.MOD Invalid UDC1l module 


11.5.3 FORTRAN Subroutine Summary 


Table 11-5 lists the FORTRAN interface subroutines supported for the 
UDC1ll under RSX-11M. (D) indicates a direct access call and the 
optional logical unit number for such a call may be specified to 
retain compatibility with RSX-11D, but this specification is ignored. 
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Table 11-5 
FORTRAN Interface Subroutines for the UDC11 


Subroutine Function 
AIRD/AIRDW Perform input of analog data in random 
sequence 

AISQ/AISQW Read a series of sequential analog input 
channels 

AO/AOW Perform analog output on several channels 
(D) 

ASUDLN Assign a LUN to UDO: 

CTDI Connect a circular buffer to receive 
contact interrupt data . 

CTTI Connect a circular buffer to receive timer 
interrupt data 

DFDI Disconnect a buffer from contact interrupts 

DFTI Disconnect a buffer from timer interrupts 

DI /DIW Read several 16<point contact sense fields 
(D) 

DOL/DOLW Latch or unlatch several l6-point fields 

DOM/DOMW Pulse several l16-point fields (D) 

RCIPT Read the state of a single contact 
interrupt point (D) 

RDDI Read the contents of a contact interrupt 
circular buffer, one point for each call 

RDTI Read the contents of a timer interrupt 
circular buffer, one entry for each call 

RSTI Read a single timer module (D) 

SCTI Set a timer module to an initial value 


The following subsections briefly describe the function and format of 


each FORTRAN 


subroutine 


call. Note the use of ASUDIN to specify a 


default logical unit number. Also consider the numbering conventions 


described in 11.7.2. 


The following FORTRAN functions do not perform I/O directly, but 
facilitate conversions between BCD and binary. 
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Convert four BCD digits to a binary number; 
IBIN = KBCD2B (IBCD) 
Convert a binary number to four BCD digits: 


IBCD = KB2BCD(IBIN) 


11.5.4 AIRD/AIRDW: Performing Input of Analog Data _ in Random 
Sequence 


The ISA standard AIRD/AIRDW FORTRAN subroutines input analog data in 
random sequence, These calls are issued as follows: 


AIRD 
CALL (inm,icont,idata, [isb] ,lun) 
ATRDW 
wheres inm specifies the number of analog input channels. 


icont is an integer array containing terminal connection 
data - channel number (right-justified in bits 0-11) 
and gain (bits 12-15), as shown in Table 11-3. 

idata is an integer array to receive the converted values. 


isb is a two-word integer array to which the subroutine 
Status is returned, 


lun is the logical unit number. 


NOTE 


lun is a required parameter 


The isb array has the standard meaning defined in section 11.5.2. Tf 
inm = 0, then isb(1) = 3. The contents of idata are undefined if an 


error occurs. 
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11.5.5 AISQ/AISQW: Reading Sequential Analog Input Channels 


The ISA standard AISQ/AISQW FORTRAN subroutines read a series of 
sequential analog input channels. These calls are issued as follows: 


AISQ 
CALL (inm,icont,idata, [isb] ,lun) 
AISQW 
where: inm specifies the number of analog input channels. 


icont is an integer array containing terminal connection 
data ~ channel number (right-justified in bits 0-11) 
and gain (bits 12-15), as shown in Table 11-3. 


idata is an integer array to receive the converted values. 


isb is a two-word integer array to which the _ subroutine 
status is returned. 


lun is the logical unit number. 


NOTE 


lun is a required parameter 


For sequential analog input, channel number is computed in steps of 
one, beginning with the value specified in the first element of icont. 
The channel number field is ignored in all other elements of the 
array. 


The gain used for each conversion is taken from the respective element 
in icont. Thus, even though the channel number is ignored in all but 
the first element of icont, the gain must be specified for each 
conversion to be performed. 


The isb array has the standard meaning defined in section 11.5.2. If 
inm = 0, then isb(l) = 3. The contents of idata are undefined if an 
error occurs. 


11.5.6 AO/AOW: Performing Analog Output 


The ISA standard AO/AOW FORTRAN subroutines initiate analog output on 
several channels. These calls are issued as follows: 


AO 


CALL (inm,icont,idata, [isb] , [lun] ) 
AOW 
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where: inm specifies the number of analog output channels. 
icont is an integer array containing the channel numbers. 


idata is an integer array containing the output voltage 
settings, in the range 00-1023. 


isb is a two-word integer array to which the subroutine 
Status is returned. - 


lun is the logical unit number (ignored if present). 


The isb array has the standard meaning defined in section 11.5.2 


11.5.7 ASUDLN: . Assigning a LUN to UDO: 
The ASUDLN FORTRAN subroutine assigns the specified LUN to UDO: and 
defines it as the default logical unit number to be used whenever a 
LUN specification is omitted from a UDC1l subroutine call. It is 
issued as follows: 

CALL ASUDLN (lun, [isw] ) 
where: lun is the logical unit number to be assigned to UDO: and 


defined as the default unit. 


isw is an integer variable to which the result of the 
ASSIGN LUN system directive is returned. 


11.5.8 CTDI: Connecting to Contact Interrupts 
The CTDI FORTRAN subroutine connects a task to contact interrupts and 
specifies a circular buffer to receive contact interrupt data. The 
length of this buffer can be computed by considering the following: 

- Rate at which contact module interrupts occur 


- Number of modules that can interrupt simultaneously 


- Rate at which the circular buffer is emptied 
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The UDCll driver generates a five-word entry for each contact 
interrupt and the interface subroutine itself requires 10 words of 
additional storage. Thus the isz parameter, described below, can be 
computed as follows: 

isz = (10 + 5 * n) 


where n is the number of entries in the buffer and isz is expressed in 
words. 


The call is issued as follows: 
CALL CTDI (ibuf,isz,iev, [isb], [lun] ) 
where: ibuf is an integer array that is to receive contact 
interrupt data. 


isz is the length of the array in words, with a minimum 
size of 15. 


iev is the trigger event flag number. The specified event 
flag is set whenever the driver inserts an entry in the 
data buffer. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number, 
The isb array has the standard meaning defined in section 11.5.2. 


11.5.9 CITI: Connecting to Timer Interrupts 
The CTTI FORTRAN subroutine connects a task to timer interrupts and 
specifies a circular buffer to receive timer interrupt data. The 
length of this buffer can be computed by considering the following: 

- Rate at which timer module interrupts occur 

- Number of modules that can interrupt simultaneously 

« Rate at which the circular buffer is emptied 
The UDCll driver generates a four-word entry for each timer interrupt 
and the interface subroutine itself requires 8 words of additional 


storage. Thus the isz parameter, described below, can be computed as 
follows: 


isz = (8 + 4 * n) 


where n is the number of entries in the buffer and isz is expressed in 
words. 
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When a timer module interrupt occurs, the driver resets the count to 
an initial value, normally that specified in iv. The initial value 
for a specific module can be modified by calling the SCTI subroutine 
(see section 11.5.19). 
The call is issued as follows: 

CALL CTTI (ibuf,isz,iev,iv, [isb], [lun] ) 
where: ibuf is an integer array that is to receive timer interrupt 


data. 


isz is the length of the array in words, with a minimum 
size of 12. 


iev is a trigger event flag number. The specified event 
flag is set whenever the driver inserts an entry in the 
data buffer. 

iv is an integer array which contains the initial timer 
module values, with one entry for each timer module, 
where entry n corresponds to timer module number ne-l. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number. 


The isb array has the standard meaning defined in section 11.5.2. 


11.5.10 DFDI: Disconnecting from Contact Interrupts 


The DFDI FORTRAN subroutine disconnects a task from contact 
interrupts. It is issued as follows: 


CALL DFDI ([isb], [lun]) 
where: isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number. 


The isb array has the standard meaning defined in section 11.5.2. 
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11.5.11 DFTI: Disconnecting from Timer Interrupts 


The DFTI FORTRAN subroutine disconnects a task from timer interrupts. 
It is issued as follows: 


CALL DFTI ([isb], [lun] ) 
wheres isb is a 2-word integer array to which the _ subroutine 
status is returned. 


lun is the logical unit number, 


The isb array has the standard meaning defined in section 11.5.2 


11.5.12 DI/DIW: Reading Several Contact Sense Fields 


The ISA standard DI/DIW FORTRAN subroutines read several 16=-point 
contact sense fields. These calls are issued as follows: 


DI 
CALL (inm,icont,idata,isb, [lun] ) 
DIW 


where: inm specifies the number of fields to be read. 


icont is an integer array containing the initial point number 
of each field to be read, 


idata is an integer array that is to receive the input data, 
16 bits of contact data for each field read. 


isb is a 2<word integer array to which the subroutine 
status is returned. 
lun is the logical unit number (ignored if present). 


The isb array has the standard meaning defined in section 11.5.2. 
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(11.5413 DOL/DOLW: Latching or Unlatching Several Fields 


The ISA standard DOL/DOLW FORTRAN subroutines latch or unlatch one or 
more 16=-point fields. These calls are issued as follows: 


DOL 
CALL (inm,icont,idata,imsk, [isb] , [lun] ) 
DOLW 
where: inm specifies the number of fields to be latched or 
. unlatched,. 


icont is an integer array containing the initial point number 
of each 16<-point field. 


idata is an integer array which specifies the points to be 


latched or unlatched; bit n of idata corresponds to 


point number icont +n; if the corresponding bit in 
imsk is set, the bit is changed; a bit value of l 
indicates latching, and 0 unlatching; each entry in 
the array specifies a string of 16 points. 


imsk is an integer array in which bits are set to indicate 
points whose states are to be changed in the 
corresponding idata bits; each entry in the array 
specifies a 16-bit mask word. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number. 


The isb array has the standard meaning defined in section 11.5.2. 


11.5.14 DOM/DOMW: Pulsing Several Fields 


The ISA standard DOM/DOMW FORTRAN subroutines pulse several 16-bit 
fields (one-shot digital output points). These calls are issued as 


follows: 


DOM 
CALL (inm,icont,idata, [idx], [isb] , [lun] ) 


DOMW 
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where: inm 


icont 


idata 


lun 


specifies the number of fields to be pulsed. 


is an integer array containing the initial point number 
of each l6-point field. 


is an integer array which specifies the points to be 
pulsed; bit n of idata corresponds to point number 
icont +n. 


is a dummy argument retained for compatibility with 
existing ISA standard FORTRAN process control calls. 


is a 2-word integer array to which the _ subroutine 
status is returned. 


is the logical unit number (ignored if present). 


The isb array has the standard meaning defined in section 11.5.2. 


11.5.15 RCIPT: Reading a Contact Interrupt Point 


The RCIPT FORTRAN subroutine reads the state of a single contact 
interrupt point. It is issued as follows: 


CALL RCIPT (ipt,isb, [lun] ) 


where: ipt 


isb 


lun 


is the number of the point to be _ read; points are 
numbered sequentially from 0, the first point on the 
first contact interrupt module. 


is a 2-word integer array to which the subroutine 
status is returned, 


is the logical unit number (ignored if present). 


The isb array has the same basic meaning defined in section 11.5.2. 


However, isb 


word 2 is set to one of the following values, 


representing the state of the point: 


Setting Meaning 
eFALSE. (0) Point is open 
eTRUE. (1) Point is closed 
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11.5.16 RDDI: Reading Contact Interrupt Data From a Circular Buffer 


The RDDI FORTRAN subroutine reads contact interrupt data from a 
circular buffer that was specified in a CTDI call (see 11.5.8 above). 
It does no actual input or output, but rather performs a 
point=-by-point scan of an interrupt entry in the buffer, returning the 
state of each point as a logical value. The trigger event flag which 
was specified in the CTDI call is also cleared, 


On the initial call to RDDI the module number and data of the next 
interrupt entry are read from the circular buffer and stored for 
subsequent reference. The subroutine then sets the current data bit 
number n to zero, examines the state of data bit n, and converts bit n 
to a point number via the following formula: 


ipt = module number * 16 +n 


On each subsequent call, n is incremented by one and then data bit n 
is examined in the stored module data. When n reaches 16, it is reset 
to zero and an attempt is made to read the next interrupt entry from 
the circular buffer. If a valid entry is not found, ipt is set 
negative and ict (if specified) is either assigned a value of zero or 
an overrun count maintained by the UDC11 driver. If ict is zero, no 
further entries remain. A nonzero value indicates that the driver 
received more data than could be stored in the buffer, and ict 
represents the number of entries that were discarded. 


The RDDI call is issued as follows: 
CALL RDDI (ipt,ival, [ict]) 


where: ipt is a variable to which the digital input point number 
is returned; it may be set as follows: 


- ipt < 0 if no valid entry is found (i.e., no 
interrupt data currently in buffer) 

ipt > 0 if the value indicated is a point number; 
the state is returned to ival 


ival is a variable to which the state of the point is 
returned; it may be set as follows: 


- FALSE. (0) if the point is open 


- TRUE. (-1) if the point is closed 
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ict is a variable to which the overrun count may be 
returned; a nonzero positive count indicates that the 
driver was unable to store the number of entries 
indicated. 


11.5.17 RDTI: Reading Timer Interrupt Data From a Circular Buffer 


The RDTI FORTRAN subroutine reads timer interrupt data from a circular 
buffer that was specified in a CTTI call (see 11.5.9 above). It does 
no actual input or output, but rather performs a scan of each entry in 
the buffer, returning the timer value for each call. The trigger 
event flag which was specified in the CTTI call is also cleared. 


When a timer module interrupt occurs, the UDCl1l driver resets the 
count to an initial value, usually that specified in the iv array on 
the CTTI call. The initial value can be modified for a _ specific 
module by calling the subroutine SCTI (see section 11.5.19). 
The RDTI call is issued as follows: 

CALL RDTI (imod,itm, [ivvn] ) 
where: imod is a variable to which the module number is’ returned; 


it may be set as follows: 


- imod <¢ 0 if no valid entry is found (i.e., no 
interrupt data currently in buffer) 


» imod > 0 if the entry is valid, indicating a 


module number; the value of the timer module is 
returned in itm 


itm is a variable to which the timer value is returned, 
ivvn is a variable to which the overrun count may be 
returned; a nonzero positive count indicates that the 


driver was unable to store the number of values 
indicated. 


11.5.18 RSTI: Reading a Timer Module 


The RSTI FORTRAN subroutine reads a single timer module. It is issued 
as follows: 


CALL RSTI (imod,isb, [lun]) 
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oe A SAREE ORE ARERR I RCCREM ASN: 


wheres imod is the module number of the timer to be read. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


lun is the logical unit number (ignored if present). 


ROSS EEE RAGA TE LE $F A DOP BLE HIVE R ET CRI HELE 


The isb array has the standard meaning defined in section 11.5.2. 


11.5.19 SCTI: Initializing a Timer Module 


The SCTI FORTRAN subroutine sets a timer module to an initial value. 
It is issued as follows: 


| 
| 
t 
i 
: 


CALL SCTI (imod,ival, [isb], [lun]) 


wheres: imod is the module number of the timer to be set. 


ival is the initial timer value, 


STRAT OE 


isb is a 2-word integer array to which the subroutine 
status is returned. 


RETR 


lun is the logical unit number. 


REMAN RNR 


The isb array has the standard meaning defined in section 11.5.2. 
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11.6 STATUS RETURNS 


ESTA 


Table 11-6 lists the error and status conditions that are returned by 
the UDC1l1 driver described in this chapter: 
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Table 11-6 
UDC11 Status Returns 


Code Reason 
Is.Suc Sucessful completion 


The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
samples completed or converted. 


IS.PND I/O request pending 


The operation specified in the QIO directive has not 
yet been executed. The I/O status block is filled with 
ZeLOS. 


a 


IE.ABO Operation aborted 


The specified I/O operation was. cancelled via IO.KIL 
while still in the I/O queue. 


IE.BAD Bad parameter 


Sh RSE SAR SCRE CORA GASSES SRI EEL EES SSSI PEE TA AE ETAT SEETHER ES EE TOI SRO LANE BOG AEN AI SLE SABRI RA Era Ro erect eta mcemeeceseemeneapesenem enti: 


An illegal specification was supplied for one or more 
of the device-dependent QIO parameters (words 6-11). 
For the UDC11, this code indicates an illegal channel 
number or gain code for the ADUOIL. 


{ 
4 
% 


IE.BYT Byte~aligned buffer specified 


a rena ie Ora engage mE 


Byte alignment was specified for a buffer but only word 
alignment is legal for the UDC1ll. Alternately, the 
length of a buffer was not an even number of bytes. 


RATES 


IE.CON Connect error 


; The task attempted to connect to contact or timer 

( : interrupts, but the interrupt was already connected to 
another task. Only one task can be connected to a 
timer or contact interrupt. Alternately a task which 
was not connected attempted to disconnect from contact 
or timer interrupts. 


SEE ASR SESE GE AAT 


SAIS CE ETER 


IE.DNR Device not ready 


5 ASE A 


The physical device unit specified in the QIO directive 
was not ready to perform the desired I/O operation. 
For the ADUO1, this code is returned if an interrupt 
timeout occurred or the power failed. 
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IE.IFC 


IE.MOD 
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Table 11-6 (Cont.) 
UDC1l Status Returns 


Reason 
Invalid event flag number 


The trigger event flag number specified in a _ connect 
function was not in the range 1 to 64. 


Illegal function 


A function code was included in an I/O request that is 
illegal for the UDC1l. The function may also refer to 
a UDCl1 feature which was not specified at system 
generation. 


Invalid UDC1ll module 
On latching output, the user specified a starting point 


number which was not legal (defined at system 
generation) or was not evenly divisible by 16. 


Device off-line 
The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 


the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Privilege violation 


The task which issued the request was not privileged to 


execute that request. For the UDC11l, this code 


indicates that a checkpointable task attempted to 


connect to timer or contact interrupts. 
Illegal address space 


The specified control, data, or interrupt buffer was 
partially or totally outside the address space of the 
issuing task. Alternately, the interrupt buffer was 
too small for a single data entry (6 words for timer 
interrupts and 7 words for contact interrupts) or a 
byte count of zero was specified, 


FORTRAN interface values for these status returns are presented in 


section 11.6.1. 
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11.6.1 FORTRAN Interface Values 
The values listed in Table 1ll-7 are returned in FORTRAN subroutine 


calls. 


Table 11-7 
FORTRAN Interface Values 


Status Return FORTRAN Value 
IS .SUC +01 
IS.PND +00 
IE.ABO +315 
ITE. ADP +101 
IE.BAD +301 
IE.BYT +319 
TE .DAO +313 
IE.DNR +303 
IE.IEF +100 
IE.IFC +302 
IE.ILU +99 
IE.NOD +323 
IE.ONP +305 
IE.PRI +316 
IE. RSU +317 
IE.SDP +102 
IE.SPC +306 
IE.ULN +08 
IE.UPN +04 


11.7 PROGRAMMING HINTS 
This section contains information on important programming 


considerations relevant to users of the UDC11 driver described in this 
chapter, 


11.7.1 Checkpointable Tasks 
Since checkpointable tasks are not allowed to have more than one 


outstanding I/O request, a task that issues a request to connect to 
timer or contact interrupts must not be checkpointable. 


11.7.2 Numbering Conventions 


Numbering is relative. Module numbers start at 0, beginning with the 
first module of a given type. 
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Channel numbers also start at 0, with channel 0 as the first channel 
on the first module of a given type. For instance, channel 10 (octal) 
is the first channel on the second analog output module, 


Point numbers start at 0, with point 0 as the first point on the first 
module of a given type. For instance, point 20 (octal) is the first 


point of the second contact sense module (i.e., relative module number 
1). 


11.7.3 Use of CTDI and RDDI for Processing Circular Buffer Entries 


Circular buffer entries should be processed in the following sequence, 


1. Execute a WAITFOR system directive predicated on the 
trigger event flag specified in the CTDI subroutine call. 


2. Repeatedly call RDDI until all valid points have been 
- yvead and ipt is negative. 


3. Perform any other processing and return to step l. 
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LABORATORY PERIPHERAL SYSTEM DRIVER 


12.1 INTRODUCTION 


The LPS1l1 Laboratory Peripheral System is a modular, real-time 
sub-system that includes the following: 


- 12 bit analog-to-digital converter, with sample and hold 
circuitry and an eight=<channel multiplexer 


- Programmable real-time clock for measuring and counting 
intervals or events 


« Display controller to display data in a 4096 by 4096 dot 
_ matrix 


« Digital input/output option (16 digital points and 
programmable relays) 


Built in a compact size and designed for easy interfacing with outside 
instrumentation, the LPS1l1 is suited to a variety of applications, 
including biomedical research, analytical instrumentation, data 
collection and reduction, monitoring, data logging, industrial 
testing, engineering, and technical education. 
At system generation, the user can specify the following: 

- Number of A/D channels 


- Whether the gain-ranging option (LPSAM=-SG) is present and the 
polarity of each channel (uni=- or bi-polar) 


. Whether the external D/A option (LPSVC and LPSDA) is present, 
and if so, the number of D/A channels 


» Clock preset value 
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12.2 GET LUN INFORMATION MACRO 


If a GET LUN INFORMATION system directive is issued for a LUN 
associated with an LPS1l11, word 2 (the first characteristics word) 
contains all zeros, words 3 and 4 are undefined, and word 5 contains a 
16-bit buffer preset value that controls the rate of LPS11 clock 
interrupts, as explained in section 12.6.1. 


12.3 QIO MACRO 


This section summarizes standard and device-specific QIO functions for 
the LPS1ll driver. 


12.3.1 Standard QIO Function 
Table 12-1 lists the standard function of the QIO macro that is valid 
for the LPSll. 


Table 12-1 
Standard QIO Function for the LPS11 


Format Function 
QIOSC IO.KIL,... Cancel I/O requests 


IO.KIL cancels all queued and in progress I/O requests. 


12.3.2 Device-Specific QIO Functions (Immediate) 


Except for IO.STP (see section 12.3.4), all device-specific functions 
of the QIO macro that are valid for the LPS1l1l1 are either immediate or 
synchronous. Each immediate function performs a complete operation, 
whereas each synchronous function simply initiates an operation. 
Table 12-2 lists the immediate functions. 
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Table 12-2 
Device=-Specific QIO Functions for the LPS11 (Immediate) 
Format Function 
QTO$C IO.LED,...,<int,num> Display number in LED lights 
QIOSC I0O.REL,...,<rel,pol> Latch output relay 
QIO$SC I0.SDI,...,<mask> Read digital input register 


QIO$SC I0.SDO,...,<mask,data> Write digital output register 


where: int is the 16<bit signed binary integer to display. 


num is the LED digit number where the decimal point is to 
be placed. 


rel is the relay number (zero or one). 
pol is the polarity (zero for open, nonzero for closed). 
mask is the mask word. 


data is the data word. 


The following subsections describe the functions listed above. 


12.3.2.1 IO.LED - This function displays a 16-bit signed binary 
integer in the light-emitting diode (LED) lights. The number is 
displayed with a leading blank (positive number) or minus’~ sign 
(negative number) followed by five nonzero-suppressed decimal digits 
that represent the magnitude of the number. LED digits are numbered 
from right to left, starting at l. 


The number may be displayed with or without a decimal point. If the 
parameter num is a number from 1 to 5, then the corresponding LED 
digit is displayed with a decimal point to the right of the digit. If 
the LED digit number is not a number from 1 to 5, then no decimal 
point is displaved. 


12.3.2.2 I0.REL - This function opens or closes the programmable 
relays in the digital I/0 status register, Approximately 300 
milliseconds are required to open or close a relay. The driver 


imposes no delays when executing this function. Thus it is the . 


responsibility of the user to insure that adequate time has elapsed 
between the opening and closing of a relay. 
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12.3.2.3 I0O.SDI - This function reads data qualified by a mask word 
from the digital input register. The mask word contains a 1 in each 
bit position from which data is to be read. All other bits are 
zero~filled and the resulting value is returned in the second I/0 
status word. 


The operation performed is: 


RETURN VALUE=MASK.AND.INPUT REGISTER 


12.3.2.4 IO.SDO - This function writes data qualified by a mask word 
into the digital output register. The mask word contains a 1 in each 
bit position that is to be written. The data word specifies the data 
to be written in corresponding bit positions. 


The operation performed is: - 


NEW REGISTER=<MASK.AND.DATA>.OR.<<.NOT.MASK>.AND.OLD REGISTER> 


12.3.3 Device-Specific QIO Functions (Synchronous) 


Table 12-3 lists the synchronous, device-specific functions of the QIO 
macro that are valid for the LPSI1l. 
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Table 12-3 
Device-Specific QIO Functions for the LPS11 (Synchronous) 
Format Function 
QIOSC IO.ADS,...,<stadd,size,pnt, Initiate A/D sampling 
ticks ,bufs,chna> 
QIOSC IO.HIS,...,<stadd,size,pnt, Initiate histogram sampling 
ticks ,bufs> ‘4 
QIO$C IO.MDA,...,<stadd,size pnt, Initiate D/A output 
ticks ,bufs,chnd> 
QIOSC IO.MDI,...,<stadd,size,pnt, Initiate digital input sampling 


ticks ,bufs ,mask> 


QIOSC IO.MDO,...,<stadd,size,pnt, Initiate digital output 
ticks ,bufs ,mask> 
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wheres stadd is the starting address of the data buffer (must be on 
a word boundary). 


size is the data buffer size in bytes (must be greater than 
zero and a multiple of four bytes). 


pnt is the digital point numbers (byte 0 = starting 
input/output point number; byte 1 - input point number 
to stop the function). 


ticks is the number of LPS11 clock ticks between samples or 
data transfers, as appropriate. 


bufs is the number of data buffers to transfer. 


chna is the A/D conversion specification (byte 0 - starting 
A/D channel number, which must be in the range 0-63. 
If the gain ranging option is present the channel 
number must be in the range 0-15 and bits 4 and 5 
specify the gain code. Byte 1 = number of consecutive 
A/D channels to be sampled, which must be in the range 
1-64) ° 


chnd is the D/A output channel specification (byte 0 = 
starting D/A channel number, which must be in the range 
0-9; byte 1 = number of consecutive channels’ to 
output, which must be in the range 1-10). 


mask is the mask word. 


The following subsections describe the functions listed above. 


12.3.3.1 IO.ADS = This function reads one or more A/D channels at 
precisely timed intervals, with or without auto gain-ranging. If two 
or more channels are specified, all are sampled at approximately the 
same time, once per interval. The auto gain-ranging algorithm causes 
a channel to be sampled at the highest gain at which saturation does 
not occur, 


Sampling mav be started when the request is dequeuved or when a 
specified digital input point is set. A digital output point may 
optionally be set when sampling is’ started, Sampling may be 
terminated by a program request (IO.STP or IO.XIL), by the clearing of 
a digital input point, or by the collection of a specified number of 


buffers of data. 


All input is double-buffered with respect to the user task. Fach time 
a half buffer of data has been collected, the user task is notified 
(via the setting of an event flag) that data is availabie to be 
processed while the driver fills the other half of the buffer. 
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The subfunction modifier bits are identical to those described in 
section 12.3.3.2; in addition, setting bit 3 to 1 means auto 
gain—ranging is requested. If bits 7 and 6 are both set to 1, the 
digital input point and. digital output point number are assumed to be 
the same. 


If auto gain-ranging is used, the LPSAM-SG hardware option must be 
present and specified at system generation. If the gain-ranging 
option is present and auto gain-ranging is not specified in bit 3 of 
the sub-function code, then bits 4 and 5 of the starting channel 
number specify the gain at which samples are to be converted. Gain 
codes are as follows: 


Code Gain 
00 1 
01 4 
10 16 
11 64 


Data words written into the user buffer contain the converted value 
in bits 0-11 and the gain code, as shown below, in bits 12-15: 


Code Gain 
0000 1 
0001 4 
0010 16 
0011 . 64 


If the LPSAM-SG option is present, then the band pass filter jumpers 
must not be clipped. Also, each channel must have been defined as 
uni- or bi-polar at system generation. 


12.3.3.2 .IO,HIS ~- This function measures the elapsed time between a 
series of events by means of Schmitt trigger one. Each time a sample 
is to be taken, a counter is incremented and Schmitt trigger one is 
tested. If it has fired, then the counter is written into the user 
buffer and reset to zero. Thus the data item returned to the user is 
the number of sample intervals between Schmitt trigger firings. 


If the counter overflows before Schmitt trigger one fires, then a zero 
value is written into the user buffer. Sampling may be started and 
stopped as described in section L224 303k All input is 
double-buffered with respect to the user task. 


The subfunction modifier bits appear below. A setting of 1 indicates 
the action listed in the right-hand column, 
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Bit Meaning 
0-3 | Unused 
4 Stop on number of buffers 
5 Stop on digital input point clear 
6 Set digital output point at start 
of operation 
7 Start on digital input point set 
(a zero specification means start 
immediately) 


12.3.3.3 IO.MDA = This function writes data into one or more external 
D/A converters at precisely timed intervals. If two or more channels 
are specified, all are written at approximately the same time, once 
per interval. Output may be started or stopped as described in 
section 12.3.3.1. All output is double-buffered with respect to the 
user task, . 


D/A converters 0 and 1 correspond to the X and Y registers of the 
LPSVC option. D/A converters 2 through 9 correspond to the LPSDA 
external D/A option. 


The subfunction modifier bits are identical to those described in 
section 12.3.3.2. 


12.3.3.4 I0O.MDI =~ This function provides the capability to read data 
qualified by a mask word from the digital input register at precisely 


timed intervals. Sampling may be started and stopped as described in . 


section 12.3.3.1. All input is double-buffered with respect to the 
user task. . 


The mask word contains a 1 in each bit position from which data is to 
be read. All other bits are zero. 


The subfunction modifier bits are identical to those described in 
section 12.3.3.2. 


12.3.3.5 IO..MDO - This function writes data qualified by a mask word 
into the digital output register at precisely timed intervals. Output 
may be started and stopped as described in section 12.3.3.1l. All 
output is double-buffered with respect to the user task. 


The subfunction modifier bits are identical to those described in 
section 12.3.3.2. 
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12.3.4 Device-Specific QIO Function (I0.STP) 
Table 12-4 lists the device-specific IO.STP function of the QIO macro, 
which is valid for the LPS1ll. 


Table 12-4 
Device-Specific QIO Function for the LPS11 (I0.STP) 


Format ~ Function 


QIOSC I0.STP,...,<stadd> Stop in-progress request 


wheres: stadd is the buffer address of the function to stop (must be 
the same as the address specified in the initiating 


request). 


12.3.4.1 I0.STP - IO.STP stops a single in-progress synchronous 
request. It is unlike IO.KIL in that it only cancels the specified 
request, whereas IO.KIL cancels all requests. 


ins dal init 1 hath acetate ic ee 


TET RE 


SEF 


FETE RR STOTT 


SAR EEN ERIE TSH ETRE ATT TROT 


SST ESE 


FOS ES RE 


EER I SETS 


BEARS aE ARNEL TE SE ERATE TSS 


ae. 


CHAPTER 12. LABORATORY PERIPHERAL SYSTEM DRIVER 


12.4 FORTRAN INTERFACE 


A collection of FORTRAN-callable subroutines provide FORTRAN programs 
access to the LPS1l. These routines are described in this section. 


Some of these routines may be called from FORTRAN as either 
subroutines or functions. All are reentrant and may be placed ina 
resident library. 


12.4.1 The isb Status Array 


The isb (I/O status block) parameter is a two-word integer array that 
contains the status of the FORTRAN call, in accordance with ISA 
convention. This array serves two purposes: 


1. It is the 2<word I/O status block to which the driver returns 
an I/O status code on completion of an I/O operation. 


2. The first word of isb receives a status code from the FORTRAN 
interface in ISA=compatible format, with the exception of the 
I/O pending condition, which is indicated by a status of 
zero. The ISA standard code for this condition is +2. 


The meaning of its contents varies, depending on the FORTRAN call that 
has been executed, but Table 12-5 lists certain general principles 
that apply. The sections describing individual subroutines provide 
more details. 


Table 12-5 
Contents of First Word of isb 


Contents Meaning 

isb(1) = 0 Operation pending; I/O in progress 

isb(1) = 1 Successful completion 

isb(1) = 3 Interface subroutine unable to generate QIO 


directive or illegal time or buffer value 


3 < ish(1) ¢ 300 QIO directive rejected and actual error 
code = -(isb(1) = 3) 


isb(1) > 300 Driver rejected request and actual error 
code = ~isb(1) = 300) 


FORTRAN interface routines depend on asynchronous system traps to set 


their status. Thus, if the trap mechanism is disabled, proper status 
cannot be set. 
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12.4.2 Synchronous Subroutines 


RTS, DRS, HIST, SDO, and SDAC are FORTRAN subroutines that initiate 
synchronous functions. When they are used, the LPS11 driver and the 
FORTRAN program communicate by means of a caller-specified data buffer 


of the following format: 


The buffer header is initialized when the synchronous function 
initiation routine is called. The length of the buffer must be even 


and greater than or equal to six. An even length is required so that 
the buffer is exactly divisible into half buffers. 


Buffer Header 


Start of Data 


Half Buffer 


Ena of Buffer 


The LPS11 driver performs double buffering within the half buffers. 
Each time the driver fills or empties a half buffer, it sets a 
user-specified event flag to notify the user task that more data is 
available or needed. The user task responds by putting more data into 
the buffer or by removing the data now available. 


If the user task does not respond quickly enough, a data overrun may 
result. This occurs if the driver attempts to put another data item 
in the user buffer when no space is available (i.e., the buffer is 
full of data) or if the driver attempts to obtain the next data item 
from the user buffer when none is available (i.e., the buffer is 


empty). 


All synchronous functions may be initiated immediately or when a 
specified digital input point is set (i.e., a start button is pushed). 


They may be terminated by any combination of a program request, the 
processing of the required number of full buffers of data, or the 
Clearing of a specified digital input point (i.e., a stop button is 
pushed). A digital output point may also optionally be set at the 
start of a synchronous function. This could be used, for example, as 
a signal to start a test instrument. 
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12.4.3 FORTRAN Subroutine Summary 


Table 12-6 lists the FORTRAN interface subroutines supported for the 
LPS11 under RSX-11M. S and F indicate whether they can be called as 
subroutines or functions. 


Table 12-6 
FORTRAN Interface Subroutines for the LPS11 


Subroutine Function 
ADC Read a single A/D channel (F,S) 
ADJLPS Adjust buffer pointers (S) 
ASLSLN Assign a LUN to LS0O: (S) 
CVSWG - Convert a switch gain A/D value to 


floating-point (F) 


DRS Initiate synchronous digital input 
sampling (S) 


HIST Initiate histogram sampling (S) 
| IDIR Read digital input (F,S) 
( IDOR Write digital output (F,S) 
IRDB Read data from a synchronous function input 
buffer (F,S) 
LED Display number in LED lights (S) 
LPSTP Stop an in-progress synchronous 
function (S) 
PUTD Put data into a synchronous function output 
( buffer (S) 
relay latch an output relay (S) 
RTS Initiate synchronous A/D sampling (S) 
SDAC Initiate synchronous D/A output (S) 


SDO Initiate synchronous digital output (S) 
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The following subsections briefly describe the function and format of 
each FORTRAN subroutine call. 


Le PR ROA TRESE 


12-11 


CHAPTER 12. LABORATORY PERIPHERAL SYSTEM DRIVER 


12.4.4 ADC: Reading a Single A/D Channel 


The ADC FORTRAN subroutine or function reads a single converted value 
from an A/D channel. If the gain-ranging option is present in the 
LPS11 hardware, the channel may be converted at a specific gain or the 
driver can select the best gain (the gain providing the most 
significance). The converted value is returned as a normalized 
floating-point number. The call is issued as follows: 


CALL ADC (ichan, [var], [igain], [isb]) 


where: ichan specifies the A/D channel to be converted. 


var is a floating-point variable that receives the 
converted value in floating-point format. 


igain specifies the gain at which the specified A/D channel 
is to be converted. The default is 1. If specified, 
igain may have the following values: 


igain Gain 
0 Autogain-ranging (driver selects gain 


that provides most significance) 


1 1 
2 4 
3 | 16 
4 64 
isb is a 2-word integer array to which the _ subroutine 


status is returned. 


“The isb array has the standard meaning described in section 12.4.1. 


When the function form of the call is used, the value of the function 
is the same as that returned in var. If this value is negative, an 
error has occurred during the A/D conversion (see section 12.5.3). 
Otherwise, this value is a floating-point number calculated from the 
following formula: 


var = (64 * converted value) / conversion gain 
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12.4.5 ADJLPS: Adjusting Buffer Pointers 


The ADJLPS FORTRAN subroutine adjusts buffer pointers for a buffer 
that the LPS11 driver is either synchronously filling or emptying. It 
is usually called when indexing is being used for direct access to the 
data in a buffer. 


When data in a buffer is to be processed only once, the IRDB and PUTD 
routines may be used, In some cases, however, it is useful to leave 
data in the buffer until processing is complete. The user program may 
process the data directly, then call ADJLPS to free half the buffer. 
Use of the routine for synchronous output functions is quite similar. 
When a half buffer of data is ready for output, ADJLPS is called to 
make the half buffer available. 


When ADJLPS is used for either input or output, care must be taken to 
insure that the program stays in sync with the LPS1l driver. If the 
program loses its position with respect to the driver, the function 
must be stopped and restarted. An attempt to overadjust will cause a 
3 to be returned in isb (1) and no adjustment to take place. 


The call is issued as follows: 
CALL ADJLPS (ibuf,iadj, [isb]) 
where: ibuf is an integer array which was previously specified in a 
synchronous input or output function. 
iadj specifies the adjustment to be applied to the buffer 
pointers. For an input function this specifies the 
number of data values that have been removed from the 
data buffer. For an output function this specifies the 
number of data values that have been put into the data 
buffer. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


The isb array has the standard meaning described in section 12.4.1. 
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12.4.6 ASLSLN: Assigning a LUN to LSO: 

The ASLSLN FORTRAN subroutine assigns a logical unit number (LUN) to 
the LPS1ll. It must be called before execution of any other LPS11 
FORTRAN function or subroutine. Subsequent calls to other interface 
routines then implicitly reference the LPS1l1 via the LUN assigned. 

The call is issued as follows: 


CALL ASLSLN (lun, [isb]) 


where: lun is the number of the LUN to be assigned to LSO: 


isb is a 2-<word integer array to which the subroutine 
status is returned. 


The isb array has the standard meaning described in section 12.4.1. 


12.4.7 CVSWG: Converting a Switch Gain A/D Value to Floating-Point 


The CVSWG FORTRAN function converts an A/D value from a _ synchronous 
A/D sampling function to a floating-point number. Each data item 
returned by the LPS1l driver consists of a gain code and converted 
value packed in a single word (see section 12.3.3.1). This form is 
not readily usable by FORTRAN, but is much more efficient than 
converting each value to floating-point in the LPS11 driver. This 
routine unpacks the gain code and value, then converts the result to a 
floating-point number. It may be conveniently used in conjunction 
with the IRDB routine (see section 12.4.12). 


The call is issued as follows: 


CVSWG (ival) 


where: ival is the value to be converted to floating point. Its 
format must be that returned by a synchronous A/D 
sampling function. The conversion is performed 
according to the following formula: 
var = (64 * converted value) / conversion gain 
For the various gain codes, 


var = x * converted value 


as shown belows 
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Gain x 
a 64 

4 16 
16 4 
64 1 


12.4.8 DRS: Initiating Synchronous Digital Input Sampling 


The DRS FORTRAN subroutine reads data qualified by a mask word from 


the digital input register at precisely timed intervals. Sampling may 


be started or stopped as for RTS (see section 12.4.17) and all input 
is double-buffered with respect to the user task. Data may be 
sequentially retrieved from the data buffer via the IRDB routine (see 
section 12.4.11), or the ADJLPS routine (see section 12.4.5) may be 
used in conjunction with direct access to the input data. The call is 
issued as follows: 


CALL DRS (ibuf,ilen,imode,irate,iefn,imask, 
isb, [nbuf], [istart], [istop]) 


wheres ibuf is an integer array that is to receive the input data 
_ walues. 


ilen specifies the length of ibuf (must be even and greater 
than or equal to six). 


imode specifies the start, stop, and sampling mode. Its 
value is encoded by adding together the appropriate 
function selection values shown below: 


Function Selection value Meaning 
128 Start on digital input point set 
. 64 Set digital output point at start 
32 Stop on digital input point clear 
16 Stop on number or buffers 
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Thus a value of 192 for imode specifies: 


- The sampling is to be started when a specified digital input 
point is set. 


- A digital output point is to be set when sampling is started. 
- Sampling will be stopped via a program request. 
irate is a 2-<word integer array that specifies the time 


interval between digital input samples. The first word 
specifies the interval units as follows: 


SOTERA BA SANTEE IRE ITED RSL BSCR AT RO AIS AE SR OE FAM CE SNES 


: 
| 


irate (1) Unit 
1 LPS11 clock ticks 
2 Milliseconds 
3 Seconds 
4 Minutes 


The second word specifies the interval magnitude as a 
16-bit unsigned integer. 


IDLER ERE TR TS TRE TE RE 


iefn specifies the number of the event flag that is to be f 
set each time a half buffer of data has been collected. 7 


TARE 


imask specifies the digital input points to be read. 


SRR LORE TE 


isb is a 2<word integer array to which the subroutine 
status is returned 


FSIS 


nbuf specifies the number of buffers of data to be 
collected. It is needed only if a function selection 
value of 16 has been added into imode. 


EERE TELS 


istart specifies the digital input point number to be used to 
trigger sampling and/or the digital output point number 
to be set when sampling is started. It is needed only 
if a function selection value of 128 or 64 has been 
added into imode,. 


iis 


istop specifies the digital input point number to be used _ to 
stop sampling. It is needed only if a function 
selection value of 32 has been added into imode,. 


When sampling is in progress, the first word of the isb array is zero 
and the second word contains the number of data values currently in 
the buffer. 
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12.4.9 HIST: Initiating Histogram Sampling 


The HIST FORTRAN subroutine measures the elapsed time between a series 
of events via Schmitt trigger one. 


Each time a sample is to be taken, a counter is incremented and 
Schmitt trigger one is tested. If it has fired, then the counter is 
written into the user buffer and the counter is reset to zero. Thus 
the data returned to the user is the number of sample intervals 
between Schmitt trigger firings. If the counter overflows before 
Schmitt trigger one fires, a zero value is written into the user 
buffer. Sampling may be started and stopped as for RTS (see _ section 
12.4.17) and all input is double-buffered with respect to the user 
task. The call is issued as follows: 


CALL HIST (ibuf,ilen,imode,irate,iefn,isb, 
{[nbuf], [istart] , [istop] ) 


where: ibuf is an integer array that is to receive the input data 
values. 


ilen specifies the length of ibuf (must be even and greater 
than or equal to six). 


imode specifies the start, stop and sampling mode. Its value 
is encoded by adding the appropriate function selection 
values shown below: 


Function 
Selection 
Value _Meaning 
128 Start on digital input point set 
64 Set digital output point at start 
32 Stop on digital input point clear 
16 Stop on number of buffers 
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irate 


iefn 


isb 


nbuf 


istart 


istop 


is a 2-word integer array that specifies the time 
interval between samples. The first word specifies the 
interval units as follows: 


irate (1) Unit 


1 LPS11 clock ticks 
2 | Milliseconds 

3 Seconds 

a « Minutes 


The second word specifies the interval magnitude as a 
16-bit signed integer. 


specifies the number of the event flag that is to be 
set each time a half buffer of data has been collected. 


is a 2-word integer array to which the _ subroutine 
status is returned. 


specifies the number of buffers of data to be 
collected. It is needed only if a function selection 
value of 16 has been added into imode. 


specifies the digital input point number to be used to 
trigger sampling and/or the digital output point number 
to be set when sampling is started. It is needed only 
if a function selection value of 128 or 64 has been 
added into imode, 


specifies the digital input point number to be used _ to 
stop sampling. It is needed only if a function 
selection value of 32 has been added into imode. 


The isb array has the standard meaning described in section 12.4.1. 


When sampling is in progress, the first word of the ish array is zero 
and the second word contains the number of data values currently in 


the buffer. 


12-18 


ie 
i 


ARS QOREETS SEG MES LS RES SATE LES RG Ey SETS SSS SS BSI 


yanperpena news ye cuenta 


a 
é ‘ 


CHAPTER 12. LABORATORY PERIPHERAL SYSTEM DRIVER 


12.4.10 IDIR: Reading Digital Input 


The IDIR FORTRAN subroutine or function reads the digital input 
register as an unsigned binary integer or as four binary-coded decimal 
(BCD) digits. In the latter case, the BCD digits are converted to a 
binary integer before the value is returned to the caller. The call 
is issued as follows: 


CALL IDIR (imode, [ival], [isb]) 


where: imode specifies the mode in which the digital input register 
is to be read. If imode equals zero, then the digital 
input register is read as four BCD digits and converted 
to a binary integer. Otherwise it is read as a l6—bit 
unsigned binary integer. 


ival is a variable that receives the value read. 
isb is a 2-word integer array to which the subroutine 
status is returned. 
The isb array has the standard meaning described in section 12.4.1. 


When the function form of the call is used, the value of the function 
is the same as that returned in ival. 


12.4.11 IDOR: Writing Digital Output 


The IDOR FORTRAN subroutine or function clears or sets bits in the 
digital output register. The caller provides a mask word and output 
mode. Bits in the digital output registers corresponding to the bits 
specified in the mask word are either set or cleared according to the 
specified mode. The call is issued as follows: 


CALL IDOR (imode,imask, [newval] , [isb]) 


where: imode specifies whether the bits specified by imask are to be 
cleared or set in the digital output register. If 


imode equals zero, then the bits are to be cleared. 


Otherwise they are to be set. 
imask specifies the bits to be cleared or set in the digital 


output register. It may be conveniently specified as 
an octal constant. 
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newval is a variable that receives the updated (actual) value 
written into the digital output register. 


isb is a 2-word integer array to which the _ subroutine 
status is returned. 


The isb array has the standard meaning described in section 12.4.1. 


When the function form of the call is used, the value of the function 
is the same as that returned in newval. 


12.4.12 IRDB: Reading Data from an Input Buffer 


The IRDB FORTRAN subroutine or function retrieves data sequentially 
from a buffer that the LPS1l1 driver is synchronously filling. If no 
data is available when the call is executed, the contents of the next 
location in the data buffer are returned without updating the buffer 
pointers. The call is issued as follows: 


CALL IRDB (ibuf, [ival]) 


wheres ibuf is an integer array which was previously specified in a 
synchronous input sampling request (i.e., DRS, HIST, or 
RTS). 


ival is a variable that receives the next value in the data 
buffer. 


When the function form of the call is used, the value of the function 
is the same as that returned in ival. 


12.4.13 LED: Displaying in LED Lights 


The LED FORTRAN subroutine displays a 16—bit signed binary integer in 
the LED lights. The number is displayed with a leading blank 
(positive number) or minus (negative number), followed by five 
non-zero suppressed decimal digits that represent the magnitude of the 
number. LED digits are numbered right to left starting at 1 and 
continuing to 5. The number may be displayed with or without a 
decimal point. The call is issued as. follows: 


CALL LED (ival, [idec], [isb] ) 
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where: ival is the variable whose value is to be displayed. 
idec specifies the position of the decimal point. A value 
of 1 to 5 specifies that a decimal point is to be 
displayed. All other values specify that no decimal 
point is to be displayed. 
isb is a 2<word integer array to which the’ subroutine 
status is returned. 
The isb array has the standard meaning described in section 12.4.1. 
For example, the following call 


CALL LED (-55,2) 


would cause ~-0005.5 to be displayed in the LED lights. 


12.4.14 LPSTP: Stopping an In-Progress Synchronous Function 


The LPSTP FORTRAN subroutine selectively stops a single synchronous 
request. The call is issued as follows: 


CALL LPSTP (ibuf) 


where: ibuf is an integer array that specifies a buffer that was 
previously specified in a synchronous initiation 
request. 


12.4.15 PUTD: Putting a Data Item into an Output Buffer 

The PUTD FORTRAN subroutine puts data sequentially into a buffer that 

the LPS1l driver is synchronously emptying. If no free space is 

available, no operation is performed. The call is issued as follows: 
CALL PUTD (ibuf,ival) 

where: ibuf is an integer array which was previously specified ina 


synchronous output request (SDO or SDAC). 


ival is a variable whose value is to be placed in the next 
free location in the data buffer. 
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12.4.16 RELAY: lLatching an Output Relay 


The RELAY FORTRAN subroutine opens or closes the LPS11 relays. The 
call is issued as follows: 


CALL RELAY (irel,istate, [isb]) 
where: irel specifies which relay is to be opened or closed (one 
for relay one, two for relay two). 


istate specifies whether the relay is to be opened or closed. 


If istate equals zero, the relay is to be opened. 


Otherwise it is to be closed. 


isb is a 2-word integer array to which the subroutine 
status is returned. 


The isb array has the standard meaning described in section 12.4.1. 


12.4.17 RTS: Initiating Synchronous A/D Sampling 


The RTS FORTRAN subroutine reads one or more A/D channels at precisely 
timed intervals, with or without auto gain-ranging. The auto 
gain-ranging algorithm causes the channels to be sampled at the 
highest gain at which saturation does not occur. 


Sampling may be started when the interface subroutine is called or 
when a _ specified digital input point is set. A digital output point 
may optionally be set when sampling is started, Sampling may be 
terminated by a program request (stop in-progress request or kill 
I/O), the clearing of a digital input point, or the collection of a 
specified number of buffers of data. 


All input is double-buffered with respect to the user task. Each time 
a half buffer of data has been collected, the user task is notified 
(via the setting of an event flag) that data is available to be 
processed while the driver fills the other half of the buffer. Data 
may be sequentially retrieved from the data buffer via the IRDB 
routine (see section 12.4.11), or the ADJLPS routine (see section 
12.4.5) may be used in conjunction with direct access to the input 


data. 
The call is issued as follows: 


CALL RTS (ibuf,ilen,imode,irate,iefn,ichan,nchan, 
isb, {nbuf], [istart] , [istop]) 
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where: 


ibuf 


ilen 


imode 


irate 


iefn 


ichan 


nchan 
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is an integer array that is to receive the converted 
data values. 


specifies the length of ibuf (must be even and greater 
than or equal to six). 


specifies the start, stop, and sampling mode, Its 
value is encoded by adding together the appropiate 
function selection values as shown below: 


Function 
Selection 
Value Meaning 
128 Start on digital input point set 
64 Set digital output point at start 
32 Stop on digital input point clear 
16 Stop on number of buffers 
8 Auto gain-ranging 


is a 2<word integer array that specifies the time 
interval between A/D samples. The first word specifies 
the interval unit as follows: 


irate (1) _Unit 

| a LPS11 clocks ticks 
2 Milliseconds 
3 Seconds 
4 Minutes 


The second word specifies the interval magnitude as a 
16-bit unsigned integer. 


specifies the number of the event flag that is to be 
set each time a half buffer of data has been collected, 


specifies the starting A/D channel of the block of 
channels to be sampled synchronously (must be between 0 
and 63). 


specifies the number of A/D channels to be sampled 
(must be between 1 and 64). 
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isb is a 2-word integer array to which the subroutine 
status is returned, 


nbuf specifies the number of buffers of data that are to be 
collected. It is needed only if a function selection 
value of 16 has been added into imode. 


istart specifies the digital input point number to be used to 
trigger sampling and/or the digital output point number 
to be set when sampling is started. It is needed. only 
if a function selection value of 128 or 64 has been 
added into imode. 


istop specifies the digital input point number to be used to 
stop sampling. It is needed only if a function 
selection value of 32 has been added into imode. 


The isb parameter has the standard meaning described in section 
12.4.1. 


When sampling is in progress, the first word of the isb array is zero 
and the second word contains the number of data values currently in 
the buffer. 


12.4.18 SDAC: Initiating Synchronous D/A Output 


The SDAC FORTRAN subroutine writes data into one or more external D/A 
converters at precisely timed intervals. Output may be started and 
stopped as for RTS (see section 12.4.17) and all input is 
double=-buffered with respect to the user task. One full buffer of 
data must be available when synchronous output is initiated. 


After SDAC has initiated output and the specified event flag has been 
set to notify the task that free buffer space is available, the PUTD 
routine (see section 12.4.15) may be used to put data values 
sequentialiy into the output data buffer. The ADJLPS routine (see 
section 12.4.5) may be used in conjunction with direct access to the 
output data buffer. The SDAC call is issued as follows: 


CALL SDAC (ibuf,ilen,imode,irate,iefn,ichan, 
nchan,isb, [nbuf], [istart], {istop]) 


where: ibuf is an integer array that contains the output data 
values. 


ilen specifies the length of ibuf (must be even and greater 
than or equal to six). 


imode specifies the start, stop and sampling mode. Its value > 
is encoded by adding together the appropriate function 


selection values as shown below: 
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irate 


iefn 


ichan 


nchan 
isb 


nbuf 


istart 


Function 
Selection 
' Value Meaning 
128 Start on digital input point set 
64 Set digital output point at start 
32 Stop on digital input point clear 
16 Stop on number of buffers 


is a 2-<word integer array that specifies the time 
interval between D/A outputs. The first word specifies 
the interval units as follows: 


irate (1) Unit 
1 LPS11 clock ticks 
2 Milliseconds 
3 Seconds 
4 Minutes 


The second word specifies the interval magnitude as a 
16-bit unsigned integer. 


specifies the number of the event flag that is to be 


get each time a half buffer of data has been output. 


specifies the starting D/A channel of the block of 
channels to be written into synchronously (must be 
between 0 and 9). 


specifies the number of D/A channels to be written into 
(must be between 1 and 10). 


is a 2-word integer array to which the subroutine 
status is returned. 


specifies the number of buffers of data to be output. 
It is needed only if function selection value of 16 has 
been added into imode,. 


specifies the digital input point number to be used to 
trigger sampling and/or the digital output point number 
to be set when sampling is started. It is needed only 
if a function selection value of 128 or 64 has been 
added into imode. 
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istop specifies the digital input point number to be used to 
stop sampling. It is needed only if a function 
selection value of 32 has been added into imode. 


The isb array has the standard meaning described in section 12.4.1. 


When sampling is in progress, the first word of the isb array is zero 
and the second word contains the number of free positions in the 


buffer. 


12.4.19 SDO: Initiating Synchronous Digital Output 


The SDO FORTRAN subroutine writes data qualified by a mask word into 
the digital output register at precisely timed intervals. Sampling 
may be started and stopped as for RTS (see section 12.4.17) and all 
input is double-buffered with respect to the user task. One full 
buffer of data must be available when output is initiated. 


After SDO has initiated output and the specified event flag has been 
set to notify the task that free buffer space is available, the PUTD 
routine (see section 12.4.15) may be used to put data values 
sequentially into the output data buffer. The ADJLPS routine (see 
section 12.4.5) may be used in conjunction with direct access to the 
output data buffer. The SDO is issued as follows: 


CALL SDO (ibuf,ilen,imode,irate,iefn,imask,isb, 
(nbuf], [istart], [istop]) 


where: ibuf is an integer array that contains the digital output 
values. 


ilen specifies the length of ibuf (must be even and greater 
than or equal to six). 


imode specifies the start, stop, and sampling mode. Its 
value is encoded by adding together the appropriate 
function selection values as shown below: 


Function 
Selection 
Value Meaning 
128 Start on digital input point set 
64 Set digital output point at start 
32 Stop on digital input point clear 
16 Stop on number of buffers 


irate is a 2-<word integer array that specifies the time 
interval between digital outputs. The first word 
specifies the interval units as follows: 
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irate (1) _Unit_ 
L LPS11 clock ticks 
~ 2 Milliseconds 
3 Seconds 
4 Minutes 


The second word specifies the interval magnitude as a 
16-bit unsigned integer. 


iefn specifies the number of the event flag that is to be 
set each time a half buffer of data has been output. 


imask specifies the digital output points that are to be 
written. It may be conveniently specifed as an octal 
constant. 


isb is a 2—word integer array to which the subroutine 
status is returned. 


nbuf specifies the number of buffers of data to be output, 
It is needed only if a function selection value of 16 
has been added into imode. 


istart specifies the digital input point number to be used to 
trigger sampling and/or the digital output point number 
to be set when sampling is started. It is needed only 
if a function selection value of 128 or 64 has been 
added into imode, 


istop specifies the digital input point number to be used to 


stop sampling. It is needed if a function selection 
value of 32 has been added into imode. 


The isb parameter has the standard meaning described in section 
12.4.1. 
When sampling is in progress, the first word of the isb array is zero 


and the second word contains the number of free positions in the 
buffer. 


12.5 STATUS RETURNS 


The error and status conditions listed in Table 12-7 are returned by 
the LPS11 driver described in this chapter. 
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Code 


IS.SUC 


IS.PND 


IE.ABO 


IE.BAD 


IE.BYT 


IE.DAO 


IE.DNR 
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Table 12-7 
LPS11 Status Returns 


Reason 
Successful completion 
The operation specified in the QIO directive was 
completed successfully. The second word of the I/O 
status block can be examined to determine the number of 
data values processed, 
I/O request pending 


The operation specified in the QIO directive has not 
yet been completed, . 


Operation aborted 


The specified I/O operation was canceled (via IO.KIL or 
IO.STP) while in progress. 


Bad parameter 

An illegal specification was supplied for one or more 
of the device-dependent QIO parameters (words 6-11). 
The second I/O status word is filled with zeros. — 


Byte-aligned buffer specified 


Byte alignment was specified for a data buffer but only 
word alignment is legal for the LPS11. Alternately, 


the length of a buffer is not an even number of bytes. 


Data overrun 


For the LPS11, the driver attempted to get a value from 
the user buffer when none was available or attempted to 
put a value in the user buffer when no space was 
available. 


Device not ready 


The physical device unit specified in the QIO directive 
Was not ready to perform the desired I/O operation, 
For the LPS11, this code is returned if a device 
timeout occurs while a function is in progress. The 
second I/O status word contains the number of free 
positions in the buffer, as appropriate, 
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Table 12-7 (Cont.) 
LPS11 Status Returns 


Reason 
Invalid event flag number 


An invalid event flag number was specified in a 
synchronous function (i.e., an event flag number that 
was not in the range 1 to 64). 


Illegal function 


A function code was included in an I/O request that is 
illegal for the LPS11l. 


Insufficient buffer space 


Dynamic storage space has been depleted, and there is 
insufficient buffer space available to allocate a 
secondary control block for a synchronous function. 


Device off-line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on-line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the configuration. 


Option not present 


An option dependent subfunction was requested, and the 
required feature was not specified at system 
generation. For example the gain-ranging option or D/A 
option is not present. The second I/O status word 
contains zeros. 


Privilege violation 
The task which issued the request was not privileged to 
execute that request. For the LPS11, a checkpointable 


task attempted to execute a synchronous sampling 
function. 


Resource in use 


A resource needed by the function requested in the QIO 
directive was being used (see section 12.5.1). 


Illegal address space 
The buffer specified for a read or write request was 
partially or totally outside the address space of the 


issuing task. Alternately a byte count of zero was 
specified. The second I/O status word contains zeros. 
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FORTRAN interface values for these status returns are presented in 
section 12.5.4. 


12.5.1 IE.RSU 


IE.RSU is returned if a function requests a resource that is currently 
being used. The requesting task may repeat the request at a later 
time or take any alternative action required. . 


Because certain functions do not need such resources, they never cause 
this code to be returned. Other functions return this code under the 
following conditions: 


Function When IE,RSU Is Returned 

I0.SDO One or more specified digital output bits are in use 
I0.ADS Digital output point (if specified) is in use 

IO.HIS Digital output point (if specified) is in use 

IO.MDA Digital output point (if specified) is in use 

IO.MDI Digital output point (if specified) or digital input 


points to be sampled are in use 
TO.MDO Digital output point (if specified) or output bits to 
be written are in use 


The following components of the LPS1l are each considered a_ single 
resource: 


Resource When Shareable 
The A/D converter Always shareable. 
and clock 


Bach bit in the digital Never shareable. 
output register 


Each bit in the digital Always shareable when used by IO.SDI or 

input register for start/stop conditions (specified in 
subfunction modifier bits), even when in 
use by another function; when specified 
by a synchronous digital input function, 
not shareable with another such 
function. 
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Each resource is allocated on a first-come-first-served basis (i.e., 
when a conflict arises, the most recent request is rejected with a 
status of IE.RSU). 


12.5.2 Second I/O Status Word 


On successful completion of a function specified in a QIO macro call, 
the IS.SUC code is returned to the first word of the I/O status block. 


Table 12-8 lists the contents of the second word of the status block, 
on successful completion for each LPS11 function. 


Table 12-8 
Returns to Second Word of I/O Status Block 


Successful Contents of Second Word 

Function 

IO.KIL Number of data values before I/O was canceled 
I0.LED Zero 

I0.REL Zero 

IO.SDI Masked value read from digital input register 
I0.SDO Updated value written into digital output register 
IO.ADS Number of data values remaining in buffer 
IO.HIS Number of data values remaining in buffer 
IO.MDA Number of free positions in buffer 

IO.MDI Number of data values remaining in buffer 
IO.MDO Number of free positions in buffer 

10.STP Zero 


When IE.BAD is returned, the second I/O status word contains zero. 
LPS1l1 driver functions return the IE.BAD code under the following 


conditions: 


I0.ADS 


Function When IE.BAD is Returned 
TO. REL Relay number not 0 or l. 


No I/O status block, illegal digital 
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IO.MDA I/O point number, or illegal channel number. 
IO.HIS No I/O status block or illegal 

IO.MDI digital I/O point number, 

IO.MDO 


12.5.3 IO.ADS and ADC Errors 


While I0O.ADS or the ADC FORTRAN subroutine is converting a sample, two 


error conditions may arise. Both of these conditions are reported to 
the user by placing illegal values in the data buffer. A -1 (177777 
octal) is placed in the buffer if an A/D conversion does not complete 
within 30 microseconds. A <2 (177776 octal) is placed in the buffer 
if an error occurs during an A/D conversion. 


12.5.4 FORTRAN Interface Values 


The values listed in Table 12-9 are returned in FORTRAN subroutine 
calls. 


Table 12-9 
FORTRAN Interface Values 


Status Return FORTRAN Value 
IS.Suc +01 
IS.PND +00 
IE.ABO | +315 
IE.ADP +101 
IE.BAD +301 
IE.BYT +319 
TE.DAO +313 
IE.DNR +303 
IE, IEF +100 
IE.IFC +302 
IE.ILU +99 
IE.NOD +323 
IE.ONP +305 
IE.PRI +316 
IE.RSU +317 
IE.SDP +102 
IE.SPC - +306 
IE.ULN +08 
IE.UPN +04 


12.6 PROGRAMMING HINTS 
This section contains information on important programming 


considerations relevant to users of the LPS11 driver described in this 
chapter. 
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12.6.1 The LPS11 Clock and Sampling Rates 


The basic LPS11 clock frequency (count rate) for all synchronous 
functions is always 10KHZ. Device characteristics word 4 contains a 
16-bit buffer preset value, set dynamically or at system generation, 
that controls the rate of "ticks" (i.e. the rate at which the LPS11 
clock interrupts). The quotient that results when this value is 
divided into 10KHZ is the rate of "ticks". For example, if this value 
is 2, the "tick" rate is 5KHZ. The user may use a GET LUN INFORMATION 
system directive to examine the value and a SET /BUF MCR function to 
modify it while the system is running. 


The ticks parameter in a synchronous function specifies the number of 
"ticks" between samples or data transfers. The value of ticks is a 
16-bit number, Thus 65,536 discrete sampling frequencies are possible 
for each of 65,536 different "tick" rates. This provides a maximum 
single-channel sample rate of 1 sample every 100 microseconds 


(possible in hardware but impractical in software) and a minimum of 1. 


sample every 429,495 seconds. A single-channel rate greater than 2KHZ 
is possible, but not recommended. 


The figures below represent initial timing tests run under RSX-11M on 
a PDP-11/40 with memory management and no gain-ranging option. It 
should be noted that no computation was performed on the data other 


than continuously removing it from or inserting it into the data 
buffer. : 


Analog rates: 
l request for 1 channel at 2.5KHZ 
1 request for 2 channels at 2.0KHZ (aggregate 4KHZ2) 


2 requests for 1 channel at 2,0KHZ (aggregate 4KHZ) 


Digital rates: 


2 requests at 2.5KH2Z (aggregate 5KH2Z) 


12.6.2 Importance of the I/O Status Block 


An I/O status block must be specified with every synchronous function. 
If the first I/O status word is nonzero, the request has been 
terminated and the value indicates the reason for termination. 
Otherwise, the request is in progress, and the second I/O status word 
contains the number of data values remaining in the buffer (or the 
number of free positions in the buffer for IO.MDA and IO.MDO). 
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12.6.3 Buffer Management 


The buffer unload protocol for synchronous input functions is 
described below. The user constructs a five-word block that contains 
the following: 


IOSB : « BLKW 2 7 I/O STATUS DOUBLE=WORD 
CURPT : «WORD BUFFER 3 ADDRESS OF BUFFER 

LSTPT s «WORD BUFFER+n ; ADDRESS OF END OF BUFFER 
FSTPTs: «WORD — BUFFER 7 ADDRESS OF BUFFER 


Two of these words are required by the driver (I/O status block) and 
the remaining three by the user to unload data values from the buffer. 


The user then issues the I/O request with the appropriate parameters 
and the address of the above block as the I/O status block. The QIO 
directive zeros both I/O status words to initialize them. 


If the driver accepts the request, it sets up a write pointer to the 
first word in the user buffer. Thus the user has a buffer read 
pointer and the driver has a buffer write pointer. The user and the 
driver share the second I/O status word, which is the number of data 
words in the buffer that contain data. 


Each time the driver attempts to put a sample value into the buffer, 
it increments the second I/O status word and compares the result with 
the size of the buffer. If the result is greater, buffer overrun has 
occurred and the request is terminated. Otherwise the value is stored 
in the buffer at the address specified by the driver's write pointer 
and the write pointer is updated. 


If the value stored in the user buffer fills half of the buffer, the 
event flag specified in the I/O request is set in order to notify the 
user that a half buffer of data is available to be processed. Each 
time the user task is awakened, it executes the following code: 


5$3 Clear efn : 
10S: TST IOSB+2 3;ANY DATA IN BUFFER? 
BEQ 30$ ;IF EQ NO 
MOV @CURPT , RO :GET NEXT VALUE FROM BUFFER 
DEC IOSB+2 REDUCE NUMBER OF ENTRIES 
ADD #2 ,CURPT sUPDATE BUFFER READ POINTER 
CMP CURPT ,LSTPT ;END OF BUFFER? 
BLOS 20$ ;IF LOS NO 
MOV FSTPT ,CURPT . RESET BUFFER READ POINTER 
20$3 Process data value ? 
BR 10$ 3;TRY AGAIN 
3083 TST IOSB ; REQUEST TERMINATED? 
BNE 40$ s;IF NE YES 
Waitfor efn : 
BR 5$ ? 
40$ Determine reason for termination 
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For IO.MDA and I0O.MDO, this protocol differs slightly. The user task 
IMaintains a write pointer and the driver a read pointer. The entire 
buffer must be full when the request is executed. 


12.6.4 Use of ADJLPS for Input and Output 


The following FORTRAN example illustrates the proper protocol for 
using ADJLPS for synchronous input and output. 


Synchronous input: 


DIMENSION IBF (1004) ,IERR(2) , INTVL (2) 


Cc 
C INITIATE SYNCHRONOUS A/D SAMPLING, 
Cc 
INTVL (1) =2 
INTVL (2) =5 
CALL RTS(IBF,1004,160,INTVL, IEFN,6,6,IERR,50,16,15) 
Cc 
C INITIALIZE HALF BUFFER INDEX 
Cc 
INDX=4 
Cc 
C WAITFOR HALF BUFFER OF DATA 
Cc 
10 CALL WAITFR(IEFN) 
Cc 
C CLEAR EVENT FLAG 
Cc 
15 CALL CLREF (IEFN) 
Cc 
C PROCESS HALF BUFFER OF DATA 
Cc 
SUM=0 
DO 20 I=1,500 
SUM=SUM+CVSWG (IBF (I+INDX) ) 
20 CONTINUE 
AVERG=SUM/500 
Cc 
C FREE HALF BUFFER FOR MORE DATA 
Cc 
CALL ADJLPS (IBF,500) 
Cc 
C ADJUST BUFFER INDEX 
Cc 


INDX=INDX+500 
IF (INDX.GE.1004) INDX=4 


CHECK IF ANOTHER HALF BUFFER OF DATA IS AVAILABLE 


aan 


IF (IERR(2) .GE.500) GO TO 15 
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IF (IERR(1).NE.0) GO TO end of sampling 
GO TO 10 
Synchronous outputs: 


DIMENSION IBF(1004) , IERR(2) , INTVL(2) 


C | 
C FIRST BUFFER OF DATA MUST BE AVAILABLE AT START 
C 
C THIS EXAMPLE ASSUMES FIRST BUFFER IS FULL AT START 
Cc 
C START SYNCHRONOUS DIGITAL OUTPUT FUNCTION 
C 
INTVL (1) =2 
INTVL (2) =5 
CALL SDO(IBF,1004,160,INTVL, IEFN,MASK,IERR,50,16,15) 
C INITIALIZE HALF BUFFER INDEX -_ 
INDX=4 
Cc 
C WAITFOR ROOM IN BUFFER 
Cc 
10 ‘CALL WAITFR(IEFN) 
C 
C CLEAR EVENT FLAG 
C 
15 CALL CLREF (IEFN) ; 
C ( 
C CALCULATE VALUES TO PUT IN BUFFER a 
C 


X=(Y+2) *Z- 
DO 20 I=1,500 
IBF (I+INDX) =X**5/A 


| 
| 
| 
| 

| 
| 

[ 
| 
i 

t 
| 
H 
c ’ 
: 
i 

| 

i 

4 


20 CONTINUE 
: SIGNIFY ANOTHER HALF BUFFER IS FULL 

. CALL ADJLPS (IBF.500) 
c ADJUST BUFFER INDEX ( 


i 
| 
n 
f 
i 
i 
i 
Hh 
i 
i 
i 


INDX=INDX+500 
IF (INDX.GE.1004) INDX=4 


CHECK IF ANOTHER HALF BUFFER IS EMPTY 


aaa 


IF (IERR(2).GE.500) GO TO 15 
IF (IERR(1).NE.0) GO TO end of sampling 
GO TO 10 


roe 


REARS EERE, 
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NOTE 


In both the above examples care is taken 
to assure that the program stays "in 
sync" with the LPS1l1l driver. If the 
program "loses" its position with 
respect to the driver the function must 
be stopped and restarted since this is 
the only way to recover. Caution should 
be exercised to insure that the above 
program sequence is used to avoid a 
possible loss of data. 
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APPENDIX A 


SUMMARY OF I/O FUNCTIONS 


This appendix summarizes legal I/O functions for all device drivers 
described in this. manual. Both devices and functions are listed 
alphabetically. The meanings of the five parameters represented by 
the ellipsis (...) are described in section 1.4.1. The meanings of 
the function-specific parameters shown below are discussed in the 
appropriate driver chapters. The user may reference these functions 
symbolically by invoking the system macros FILIO$ (standard I/0 
functions) and SPCIO$ (special I/O functions), or by allowing them to 
be defined at task build time from the system object library. 
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APPENDIX A. SUMMARY OF I/O FUNCTIONS 


A.1l ANALOG-TO-DIGITAL CONVERTER DRIVERS 
IO.KIL,eee Cancel I/O requests 


IO.RBC,...,<stadd,size,stcnta> Initiate an A/D conversion 


A.2 CARD READER DRIVER 


IO.ATT coe Attach device 

TO, DET ys Detach device 

IO. KIL,...6 Cancel I/O requests 

IO. RDB,...,<stadd,size> Read logical Bleak (binary) 
IO.RLB,..-,<stadd,size> Read logical block (alphanumeric) 
IO. RVB,...,<stadd,size> ; Read virtual block (alphanumeric) 


A.3 CASSETTE DRIVER 
IO.ATT eee 

—I0.DET,... 

IO. EOF pee 

IO.KI Lycee 

10. RLB,...,<stadd,size> 
IO. RVB,...,<stadd,size> 
IO. RWD, cee 
I0.SPB,...,<nbs> 
IO.SPF,...,<nes> 
IO.WLB,...,<stadd,size> 


IO.WVB,...,<stadd,size> 


Attach device 
Detach device 

Write end-of-file 
Cancel I/O requests 
Read logical block 
Read virtual block | 
Rewind tape 

Space blocks 

Space files 

Write logical block 


Write virtual block 


A.4 COMMUNICATION DRIVERS (MESSAGE-ORIENTED) 


IO.HDXy,eee 


IO.INL,. ee 


Set device to half-duplex mode 


Initialize device and set device 


characteristics 
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IO.RLB,...,<stadd,size> 


IO. RNS,...,<Stadd,size> 
IO.WYN,...,<Syn> 


IO. TRM,z eee 


IO.WLB,...,<Stadd,size> 


IO.WNS,...,<Sstadd,size> 


A.5 DECTAPE DRIVER 

IO. RLB,...,<stadd,size,,,lbn> 
IO. RLV,.«.,<Stadd,size,,,lbn> 
IO.RVB,..-,<Sstadd,size,,,lbn> 
IO.WLB,...,<Stadd,size,,,lbn> 
IO.WLV,...,<Stadd,size,,,lbn> 


IO.WVB,...,<Stadd,size,,,lbn> 


Ae6 DISK DRIVER 


Read logical block, stripping 
syne characters 


Read logical block, transparent mode 
Specify sync character 


Terminate communication, disconnecting 
from physical channel 


Write logical block with syne leader 


Write logical block, no sync leader 


Read logical block (forward) 
Read logical block (reverse) 
Read virtual block (forward) 
Write logical block (forward) 
Write logical block (reverse) 


Write virtual block (forward) 


IO.RLB,...,<Sstadd,size, ,blkh,blkl> Read logical block 


10.RVB,...,<stadd,size,,blkh,blkl> Read virtual block 


IO.WLB,...,<stadd,size,,blkh,blkl> Write logical block 


IO.WVB,...,<stadd,size, ,blkh,blk1> Write virtual block 


A.7 LABORATORY PERIPHERAL SYSTEM DRIVER 


IO.ADS,...,<stadd,size,pnt, 
ticks ,bufs ,chna> 


IO.HIS,...,<stadd,size,pnt, 
ticks ,bufs> 


IO.KIL,..- 


IO.LED,...,<int,num> 


Perform A/D sampling 
Perform histogram sampling 


Cancel I/O requests 


Display number in LED lights 
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IO.MDA,...,<stadd,size,pnt, 
ticks ,bufs,chnd> 


IO.MDI,...,<stadd,size,pnt, 
ticks ,bufs ,mask> 


IO.MDO,...,<stadd,size,pnt, 
ticks ,bufs ,mask> 


Io. REL, eee 7<rel,pol> 
IO.SDI,...,<mask> 
IO.SDO,...,<mask,data> 


IO.STP,...,<stadd> 


A.8 LINE PRINTER DRIVER 
IO.ATT p00 

IO.DET , ce. 

EOURIL pein | 
IO.WLB,...,<stadd,size,vfc> 


IO.WVB,..-,<Sstadd,size,vfc> 


A.9 MAGNETIC TAPE DRIVER 
IO.ATT poe. 

IO.DET , eee 

IO.EOF eee 

IO.KI Lycee 

IO. RLB,...,<Sstadd,size> 
IO. RVB,...,<stadd,size> 
IO. RWDyeee 

ITO. RWU yee 

ITO.SECy eee 


TVeSMOye007<CbD> 


Perform D/A output 
Perform digital input sampling 
Perform digital output 


Latch output relay 
Read digital input register 
Write digital output register 


Stop in=-progress request 


Attach device 
Detach device 
Cancel I/O requests 
Write logical block 


Write virtual block 


Attach device 

Detach device 

Write end-of-file (tape mark) 
Cancel I/O requests 

Read logical block 

Read virtual block 

Rewind tape 

Rewind and turn unit off-line 


Read tape characteristics 


Mount tape and set tape characteristics 
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I0.SPB,...,<nbs> 
IO.SPF,...,<nes> 
IO.STC,.0e,<Cb> 
IO.WLB,...,<stadd,size> 


IO.WVB,...,<stadd,size> 


A.10 TERMINAL DRIVER 
IO.ATT cee 

IO.DET,... 

LOKI Lycee 
I0O.RLB,...,<stadd,size> 


Io. RVB, eee ,<stadd,size> 


IO.WLB,...,<stadd,size,vfc> 


IO.WVB,...,<Stadd,size,vfc> 


Space blocks 

Space files 

Set tape characteristics 
Write logical block 


Write virtual block 


Attach device 
Detach device 
Cancel I/O requests 
Read logical block 
Read virtual block 
Write logical block 


Write virtual block 


A.ll UNIVERSAL DIGITAL CONTROLLER DRIVER 


I0O.CCI,...,<stadd,sizb,tevf> 


IO.CTI,...,<stadd,sizb,tevf,arv> 


IO.DCI,... 


IO.DTI, 200 


I0,iTi,. ee ,<mn ,ic> 
IO.KIL,... 


IO.MLO, eee 7SOpn ,pp,dp> 


IO. RBC,...,<stadd,size,stcnta> 


Connect a buffer to contact 


interrupts 


interrupts 


Disconnect a buffer from contact 


interrupt 


Disconnect a buffer from timer 


interrupts 
Initialize a timer 


Cancel I/O requests 


Open or close latching digital 


output points 


Initiate multiple A/D conversions 


Connect a buffer to timer 
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APPENDIX B 


I/O FUNCTION AND STATUS CODES 


This appendix lists the numeric codes for all I/O functions, directive 
status returns, and I/O completion status returns. Lists are 
organized in the following sequence: 

- 1/0 completion status codes 

- Directive status codes 

- Device-independent I/O function codes 


- Device-dependent I/O function codes . 


Device-dependent function codes are listed by device. Both devices 
and codes are organized in alphabetical order. 


For each code, the symbolic name is listed in form IO.xxx, IE.xxx, or 
IS.XxXxX. A brief description of the error or function is also 
included. Both decimal and octal values are provided for all codes. 


B.l I/0 STATUS CODES 


This section lists error and success codes which can be returned in 
the I/O status block on completion of an I/O function. The codes 
below may be referenced symbolically by invoking the system macro 
IOERRS. 


Bell I/O Status Error Codes 


Name Decimal Octal Meaning 

IE.ABO -15 177761 Operation aborted 
IE.ALN -34 177736 File already open 
IE.BAD -01 177777 Bad parameter 
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IE.BBE 
-IE.BLK 
IE.BYT 
IE.CON 
IE.DAA 
IE.DAO 
IE.DNA 
IE.DNR 
IE, EOF 
IE.EOT 
IE.EOV 
IE. FHE 
IE.IFC 
IE.MOD 
IE.NLN 


IE.NOD 


IE.OFL 
IE.ONP 
IE.OVR 


IE.PRI 


IE.RSU 


IE.SPC 
IE.VER 


IE.WLK 


FUNCTION AND STATUS CODES 


177710 
177754 
177755 
177752 
177770 
177763 
177771 
177775 
177766 
177702 
177765 
177705 
177776 
177753 
177733 
177751 


177677 


177773 - 


177756 
177760 
177757 
177772 
177774 
177764 


Bad block 

Illegal block number 
Byte-aligned buffer specified 
UDC connect error 

Device already attached 
Data overrun 

Device not attached 
Device not ready 
End-of-file encountered 
End-of-tape encountered 
End-of-volume encountered 
Fatal hardware error 
Illegal function 

Invalid UDC module 


File not open 


“No dynamic memory available 


to allocate a secondary 
control block. 


Device off-line 

Illegal subfunction 

Illegal read overlay request 
Privilege violation 
Shareable resource in use 
Illegal address space 
Unrecoverable error 


Write-locked device 
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B.1.2 I/O Status Success Codes 


Name Decimal Octal Meaning 

IS.CR Byte 0: 1 006401 Successful completion with 
Byte ls 15 carriage return 

IS.ESC Byte 0: lL 015401 Successful completion 
Byte l: 33 with ESCape 

IS.PND +00 . 000000 I/O request pending 

ISs.suc +01 000001 Successful completion 


B.2 DIRECTIVES CODES 


This section lists error and success codes which can be returned in 
the directive status word at symbolic location S$DSW when a QIO 
directive is issued, 


B.2.1 Directive Error Codes 


Name. Decimal Octal Meaning 

IE.ADP -98 177636 Invalid address 

IE.IEF -97 . 177637 Invalid event flag number 

IE. ILU ~96 177640 Invalid logical unit number 
IE.SDP -99 177635 Invalid DIC number or DPB size 
TE.ULN -05_— 177773 Unassigned LUN . 

IE.UPN -01 177777 Insufficient dynamic storage 


B.2.2 Directive Success Codes 
Name: Decimal Octal Meaning 


IS.SUC +01 000001 Directive accepted 


B.3 I/O FUNCTION CODES 


This section lists codes for all standard and device-dependent I/0 
functions. 
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B.3.1 Standard I/O Function Codes 


I/O FUNCTION AND STATUS CODES 


Meaning 


Name Octal Words Octal Bytes 
Code Subcode 

IO.ATT 001400 3 0 Attach device 
I0.DET 002000 4 0 Detach device 
IO.KIL 000012 0 12 Cancel I/O requests 
IO. RLB 001000 2 0 Read logical block 
IO. RVB 010400 21 0 Read virtual block 
IO.WLB 000400 1 0 Write logical block 
IO.WVB 011000 22 0 Write virtual block 


B.3.2 Specific A/D Converter I/O Function Codes 


Name Octal Words Octal Bytes 


Code Subcode 


Meaning 


IO. RBC 


003000 


6 0 


Initiate an A/D conversion 
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TNS 


B.3.3 Specific A/D Converter I/O Function Codes 


Name Octal Words Octal Bytes Meaning 
Code Subcode 
IO. RDB 001200 — | 2 200 


Read logical block (binary) 


SRE NTT! 


: ‘ 


B.3.4 Specific Cassette I/O Function Codes 


Name Octal Words Octal Bytes Meaning 
Code Subcode 
IO. EOF 003000 6 0 End-of-file encountered - 
IO. RWD 002400 5 0 Rewind tape 
IO.SPB 002420 5 20 Space blocks 
IO.SPF 002440 5 40 Space files 


QR RESET 


SRT EE 
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B.3.5 Specific Communication (Message-Oriented) I/O Function Codes 


Name Octal Words | Octal Bytes Meaning 


Code Subcode 


I0.HDX 003010 6 10 Set device to half-duplex mode 

I0.INL 002400 5 0 Initialize device and 
set device characteristics 

IO. RNS 001020 2 20 Read logical block, 
transparent mode 

IO.SYN 003040 6 40 Specify sync character 

I0.TRM 002310 5 10 Terminate communication, 
disconnecting from physical 
channel 

IO.WNS 000410 1 10 Write logical block with no 


sync leader 


B.3.6 Specific DECtape I/O Function Codes 


Name Octal Words Octal Bytes Meaning 

Code Subcode 
ITO.RLV 001100 2 100 Read logical block (reverse) 
IO.WLV 000500 1 100 Write logical block (reverse) 


B.3.7 Specific LPS I/O Function Codes 


Name Octal Words Octal Bytes Meaning 

Code Subcode | 
IO.ADS 014000 30 0 Initialize A/D sampling 
IO.HIS 015000 32 0 Initialize histogram sampling 
IO.LED 012000 24 0 Display number in LED lights 
IO.MDA 016000 34 0 Initialize D/A output 
IO.MDI 014400 31 0 Initialize digital input 

sampling — 

IO.MDO 015400 33 0 Initialize digital output 
IO. REL 013400 27 0 Latch output relay 
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I0.SspDI 
I0.SDO 


I0.STP 


013000 
012400 
016400 


26 
25 


35 


I/O FUNCTION AND STATUS CODES 


Read digital input register 
Write digital output register 


Stop in=-progress request 


B.3.8 Specific Magtape I/O Function Codes 


Name 


IO, EOF 
IO. RWD 
IO. RWU 
IO.SEC 
I0.SMO 
IO.SPB 
IO.SPF 


I0.STC 


B.3.9 Specific UDC I/O Function Codes 


Name 


IO,CCI 


I0,.CTI 


I0.DCI 


I0,DTI 
I0.1iTft 


I0O.MLO 


IO, RBC 


Octal Words 


003000 
002400 
002540 
002520 
002560 
002420 
002440 


002500 


Octal Words 


014000 
015400 


014400 


016000 
017000 
006000 


003000 


Code 


6 


awn wm oO WwW Ww WN 


Code 


30 


33 
31 


Octal Bytes 
Subcode 


100 


Octal Bytes 
Subcode 


0 


Meaning 


Write end-of-file gap 

Rewind tape 

Rewind and unload 

Sense characteristics 

Mount and set characteristics 
Space blocks 

Space files 


Set characteristics 


Meaning 

Connect a buffer to contact 
interrupt digital input 
Connect a timer 

Disconnect a buffer from 
contact interrupt digital 
input 

Disconnect a timer 


Initialize a timer 


Open or close latching 
digital output points 


Initiate multiple 
A/D conversions 


ra ip 
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APENDIX C 


RSX-11M PROGRAMMING EXAMPLE 


MACRO MB71@ 1080CT#74 18319 PAGE 1 


7e we we we WS te CE we GE FE BO Te CH UH 8H TO TH BS OF 8 Me we Ae 


eTITLE MESSAGE TRANSFER 

eIDENT /@1i/ 
COPYRIGHT 1974, DIGITAL EQUIPMENT CORP,, MAYNARD, MASS, 
THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A LICENSE FOR USE 
ON A SINGLE COMPUTER SYSTEM AND CAN BE COPIED (WITH INCLUSION 
OF DEC’S COPYRIGHT NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCE9T 
AS MAY OTHERWISE BE PROVIDED IN WRITING BY DEC. 
THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION, 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
OF ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SJPPLIED BY DEC, 


VERSION @1 
EARL WALDIN 5aSEP@74 
DEMONSTRATION OF USE OF RSXe11M 1/0 


MACRO LIBRARY CALLS 
eMCALL ALUNSS,91I0$S,WTSESS,WSIGSS 


LOCALLY DEFINED MACROS 


»MACRO CALL SUBR tDEFINITION FOR SUBROUTINE CALLS 
JSR PC,SUBR 
oENDM 
eMACRO RETURN tSUBROJTINE RETURN MACRO 
RTS BC 
eENDM 
LOCAL DATA 


A SRE IEICE IEE ES RT CETTE ST TTT SE IE TICLE RTE ETERS SG SE ER LEER ELLE ETE REA METTLE EI LOO ENE TEI SLES IIT AS ER ESE TATED EE ITI 


BER SS SEB BE EAT GORE SETLIST SG EAS EES SRDS SESS LIE RETEST ISI I ESE 


Oa HOMBRE PARI ATE TER BOS STE SL tien OTR RB 


AapRrRE RE Sa ARES 


47 
48 
49 
538 
51 
Se 
33 
54 
55 
56 
57 


MESSAGE 


58 
59 
68 
61 
62 
63 
64 
65 


66. 


67 
68 


@90008 900004 RDSTSt WORD ) 


BG98022 w4s00u8 


840884 aBagoa 


TRANSFER 


090006 


G000108 
000132 


Q88254 
BA8274 


O40314 
Q06366 
8983728 
828374 


600376 
@08410 


020416 
8004208 


088424 


O20432 
808582 
888504 
Q06510 


808512 
B08564 
880566 
828572 


888008 


183803 


@B0747 


126727 
177364 
BBB008G 
881402 
O98167 
888448 


B16701 
177352 


123003 


OBB747 


183063 
888747 


3 READ*RELATED STORAGE 
3 


sREAD STATUS BLOCK 
e NORD Q 


3 
3 WRITE@RELATED STORAGE 
3 


WRSTSt WORD Y sWRITE STATUS BLOCK 


MACRO M@71@ 1B9O0CTe74 18319 PAGE lel 
WORD \] 


3 
3 BUFFER STORAGE 
U 


BUF 18 8LKB 82, SBUFFER 1 
BUF 23 » BLKB 82, +BUFFER 2 
3+ | 


$ ex@SXFER@DEMONSTRATE USE OF RSXeL1M I/0 BY OUTPUTTING RECORDS 

s FROM TI: C(USER®S TERMINAL) TO LINE PRINTER, REQUESTS ARE DOUBLE 
3} BUFFERED TO DEMONSTRATE HOW OPERATIONS MAY BE OVERLAPPED. 

fu 


SXFERs3 ALUNSS #1,8"TI,#8 sLUN 1 IS TIs DEVICE 
ALUNSS #2,9" LP sLUN 2 IS LPOs 


3 
1 READ A LINE FROM INOUT DEVICE, LUN 1t 

, 

12$3 QIO$s #TO,RLB,#1,41,,4RDSTS,, <#BUFL,#80,> 


BCC 20$ ¥IF DISPATCHED OK, CONTINUE 
CALL STCKHK sCHECK STATUS 
BR 10% tIF RECOVERABLE ERRORe TRY AGAIN 


208: WTSESS #1. SWAIT UNTIL 1 COMPLETE 
CMPB  -s-aRDSTS,#IS,SUC READ SUCCESSFUL? 


BEQ 308 SCONTINUE IF SUCCESSFUL 
JMP 12008 STERMINATE IF NOT SUCCESSFUL 
308% Moy RDSTS+2,R1 $GET ACTUAL BYTE COUNT IN Rt 


' 

+ BEGIN TO FILL SECOND BUFFER 
’ . . 
4O$s GIOSS #I0,RLB,#1,42,,4RDSTS,,<#BUF2, #60,> 


BCC 58$ -  gCONTINUE IF DISPATCH OK 
CALL STCHK ICHECK STATUS 
BR 48$ sTRY AGAIN 


U 
3 START BUFFER 1 OUT 


58$:3 Qro$ss RIO. WLB, #2, #1,,4#NRSTS,,SA#BUFIL,R1, #48> 


BCC 68$ sCONTINUE IF NO DISPATCH ERROR 
CALL STCHK sCHECK STATUS 
BR 388 sTRY AGAIN 


THIS IS A SYNCHRONIZATION POINT, BOTH FUNCTIONS MUST COMPLETE 
BEFORE ANYTHING ELSE BEGINS, 


? es 


js 


AA BE EGER TRL ORS EP TE SAE BLL SEES RT ERSTE I i STEUER ESE PCE IPE ITE IISA 8 TC CNR ECE PN 


ASTRA ASE ESSE OR PT BOTTA 


SECRETE NE NT EET 


5 SESE BT LER ET YTB ST ESTE 


RESO 


k 
Hy 
i 
t 
4 
i 
i 
x 
iq 


EO ERIC UR ARATEP POHL HE HR SITE RR SU 


Panama an acosnare wee 


Pa 


Pp iaaiea 


or, 


MESSAGE 


TRANSFER 


@A0574 
080686 


G20614 
028616 


B2062e2 
080634 


BAB642 


Q8G644 
@08716 
008728 
@00724 


889726 
001808 
@8128e 
B01006 


001818 
B81B822 


001030 
001032 
021036 
801058 


801056 
001069 


801064 


126727 
177166 
8800886 
981123 
816782 
177168 


126727 
177144 
8880086 
981119 


163983 
BO8747 


183003 
088747 


126727 
176752 
aaanedc 
aa1015 
A16701 
176744 


126727 
176732 
Q8B008G 
@01802 
800167 
177344 


a6e0084 
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68$s 


WTSESS #2 sWAIT FOR 2 TO FILL 
CMPB ROSTS,#IS,SUC sSUCCESSFUL? 


BNE 120$ sIF NOT, CRASH 

MOV RDSTS+e,R2 sGET COUNT FOR BUFFER e 
WTSESS #1 sWAIT FOR 1 TO EMPTY 
CMPB WRSTS,#IS,SUC sSUCCESSFUL? 


BNE 128$ tIF NOT, CRASH 


3 FILL BUFFER i, EMPTY BUFFER @ 


’ 
7083 


8B$% 


Qross #TO.RLB,#1,41,,/4ROSTS,, <#BUF1,#60,> 
BCC 883 sIF OK, CONTINUE © 
CALL STCHK + CHECK STATUS 

BR 7Q$ sTRY AGAIN 


Qross BIO,WLB, #2, 82,5 4WRSTS, , SABUF2, RO, #40> 

BCC 98% sCONTINUE IF SUCCESSFUL 

CALL STCHK +CHECK STATUS IF NOT SUCCESSFUL 
BR 88S sRETURN 


$ 
# THIS IS ALSO A SYNCHRONIZATION POINT 


9083 


WTSESS #1 sWAIT FOR 1 TO FILL 
CMPB RDSTS,#IS,SuUC sSUCCESSFUL? 


BNE —«- 1088 sIF NOT, CRASH | 

MOV RDSTS+#2,R1 sGET ACTUAL BYTE COUNT IN Ri 
WTSESS #2 }WAIT FOR BUFFER 2 TO EMPTY 
CMPB  -WRSTS,#IS.SUC  3SUCCESSFUL? 


BNE 122$ sTERMINATE IF NOT 
JMP 40$ sBACK INTO LOOP 


3 
s DON*T ATTEMPT TO RECOVER ERRORS 


5 
10083 


t+ 


IOT sCRASH TASK 


3 «xe STCHK @ ATTEMPT TO RECOVER DIRECTIVE DISPATCH ERROR ONLY IF 
t IT INVOLVES DYNAMIC MEMORY ALLOCATION * OTHERWISE TERMINATE, 


INPUTS? 
(SP) SRETURN ADDRESS. 


STAG SILER 8 RG SATEEN LANE REE TE OTT CREE SS EP SEER SEN BP PEC IS EAE SE SSE SAAS ASAT AES AEA AREA EI ete hn RH AA RRS EN OTN PERRIS SE ITA AO IE 


SERGEANTS SS GSA RE EET OEE FI TEST 


AE GR ERSTIOT LAE RARER SET 
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i 
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MESSAGE TRANSFER 
157 
158 
159 
168 
161 
162 
163 881066 126727 
ABBAAGG 
Q280889G 
164 #8461074 881004 
165 001076 
166 @61104 
167 
168 801106 #280004 
169 
176 2@0254° 
MESSAGE TRANSFER 
SYMBOL TABLE 
BJF 1 OA2GG1AGR 
BJF2 @@0132R 
IE. JPNS xrerxe GX 
TO.2LB= xxxake GX 
. ABS. @¥4a00 B00 
QO91110 Avi 


ERRORS NETECTEDs @ 


FREE CORE: 3586, wORDS 
»4MSG/LI:TIM=MSG,481 
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; 
Hi 
$ 
3 
3 


STCHK: 


103: 


OUTPUTS: 
NONE 


CMPB $DSW, #IE UPN 


BNE 105 
WSIGS$S 
RETURN 

IOT 


eEND SXFER 


#BUFFER ALLOCATION FAILURE? 


sIF NOT TERMINATE 
sAWAIT SIGNIFICANT EVENT 
sTRY AGAIN 


sCRASH TASK 


MACRO M@710 1880CTe74 10219 PAGE 1e4 


TO.WLB= 
Is.sucs 
RASTS 
STCHK 


kkkKKK GX WRSTS 
kkkkke CX $DSW = 
BASAaB9R $XFER 


Q@2iZ66R SSSARG= 


2AGGG4R 
akkaee BX 
298254RG 
82280862 
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APPENDIX D 


GLOSSARY OF RSX-11M TERMS 


ASYNCHRONOUS SYSTEM TRAP (AST) 


REGS SSO ET IESE RAS RAIA OB LE PONE OAR RELEASE APR 


A system condition which occurs as a result of an external 
significant event such as completion of an I/O request. On 
occurrence of the significant event, control passes to an AST 
service routine, and the AST is added to an Executive 
first-in first-out queue for the task in which the service 
routine appears. 


ATTACH 


Dedicate a physical device unit for exclusive use by the task 
that requested attachment. Once the physical device unit has 
been attached by a task, using an IO.ATT I/O function, only 
that task can free the unit again for use by other tasks in 
the system. Attachment request attempted to a device unit 
already attached by another task will not be terminated until 
the attachment request can finally be honored; in other 
words, the attachment request is terminated only when the 
: previous attachment is terminated, and no higher priority 
( attachment requests are queued. 


DETACH 
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Free an attached physical device unit for use by tasks other 
than the one that attached it. A physical device unit can 
only be detached, by means of an IO.DET I/O function, by the 
task that attached it, or by the Executive if the task is 
terminated with the device still attached. 


EAT 


a DIRECTIVE 


IIR EES EERE TESST TEP TEE 


A type of system meta-instruction which is used to provide a 
facility inherent in the hardware by means of executive 
requests issued to the RSX-1l1M Executive. Directives are 
usually invoked by means of execution of expanded code from 
macros in the System Macro Library (RSXMAC.SML). 


eae cote 


EVENT FLAG NUMBER 


A number which can be specified in a QIO or other macro call 
to indicate to the issuing task which significant event has 
occurred, There are 64 event flags available in RSX-11M. 
Flags numbered 1 through 32 are local to a task; 33 through 
64 are common to all tasks. Flags 25 through 32 and 957 
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through 64 are normally reserved for RSX-11M system software 
use. Each of the available flags can be referenced by number 
and can be used for communication and synchronization between 
user tasks, or between tasks and executive service requests, 
including I/O requests. 


RTE SO PETS RI PSEC PSOE ARE I EOE RSI AOE PS MR" 


I/O STATUS BLOCK 


A 2-word array (double-word) in which a code representing the 
final status of an I/O request is returned, if the address of 
the block is specified in the QIO macro call which generatéd 
the request. A code identifying the type of success or error 
is returned in the low-order byte of the first word, optional 
device-dependent information in the high-order byte, and the 
number of bytes transferred on a read or write in the’ second 
word of the block. Although the I/O Status Block is 
optional, it is the only way a user can guarantee that he 
will know the outcome of an I/O request. 
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LOGICAL ADDRESS 


A logical address is a software representation of a hardware 
address. The use of the phrase "logical address" implies 
that some mapping occurs between "true", or hardware address 
and “artificial" or logical address. The reason for using 
logical addresses is that they simplify the way one deals is 
with a hardware device or family of devices. 


EAL TOTS TTT TT 


SRE 


i 
The logical address in RSX-11M refers to the relative 
position of a logical block on a volume. The volume is i 
divided into logical blocks, each of which is assigned an i 
address called a logical block number (LBN). All mass 
storage media are accessed by LBN (e.g., 17) rather than | 
physical address (e.g., cylinder 5, track 3, sector 7). H 


LOGICAL BLOCK . { 


A logical block in RSX=-11M parlance refers to 512 bytes of 
storage which may be considered to be a discrete entity for 
logical purposes. In fact, it might be composed of odd-sized 
fragments of non-contiguous storage, Actually, a logical 
block generally refers to one or more physical blocks of a 
formatted or block=-structured mass memory which compose the 
logical atom for access to the medium. . Logical block may 
also refer to the in-core image of a logical block which is 
or will be on a mass storage device, 


SASS eT REE 


REESE 


The concept of logical block is useful on file-structured 
devices, in that all such devices appear to _ share all 
characteristics but total number of blocks. 
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LOGICAL BLOCK NUMBER (LBN) 


Sequential position of a logical block with respect to a 
collection of such blocks (which may compose a volume). If 
the collection of blocks had been written in logical order on 
a sequential medium, such as magnetic tape, the logical block 
number for any block would be the true position of the block 
on that medium, e.g., logical block 2 would be encountered 
just after LBN 1 and just before LBN 3. 


LOGICAL UNIT NUMBER (LUN) 


MACRO 


PRIORITY 


A number associated with a physical device unit during a 
task's I/O operations. Each task in the system can establish 
its own correspondence between LUNs and physical device 
units. 


A system capability which allows a user to generate Assembler 
instructions, data, or symbols in a predetermined format by 
providing actual arguments to the Assembler in a macro call 
included in a MACRO=11 program. Macros provide a 
standardized means of obtaining access to system services or 
resources by invocations from programs. 


A number associated with an RSX-11M task which indicates the 
relative position of that task among all tasks in the system. 
The priority is associated with a task at task build time and 
may be changed at run time. Legal priorities are in range l 
through 250, with greater magnitude indicating higher 
priority. If two tasks are identical in every way (i.e., 
resources used, etc.) except priority and are initiated at 
the same time, the task with the higher priority will 
complete first. I/O requests issued by a task assume _ the 
priority of that task and are honored according to the task's 
priority. 


SIGNIFICANT EVENT 


An event or condition which indicates a change in system 
status. In RSX-11M, a significant event is declared when an 
I/O operation completes and in some other cases as well. A 
declaration of a significant event indicates that the 
Executive should review the eligibility of all tasks in the 
system to determine which task should run next, since the 
significant event might unblock the execution of a higher 
priority task. 
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SYNCHRONOUS SYSTEM TRAP (SST) ( 


A system condition which occurs as a result of an error or 
fault within the executing task. If the same instruction 
“sequence were repeated, the same synchronous trap would 
occur. On recognition of a synchronous trap, control passes 
to an SST service routine. SSTs are not handled directly by 
the Executive as ASTs are. 


VIRTUAL ADDRESS 


A number which indicates relative position within a 
collection of logically-related granules of a storage medium, 

The fact that the medium itself may be virtual (e.g., 1 

million bytes of addressable memory, but only 64K in core 

memory, the remainder on mass_ storage) is of little 
consequence; in fact, the ability to deal with a ge 2 
hierarchical or multi-level memory as if it were one medium Foca 
is one of the principal advantages of systems supporting Man 
virtual addressing. In RSX-11M, virtual address generally 

refers to relative position within a task image, while 

VIRTUAL BLOCK NUMBER (VBN) refers to relative position within 

a file. 


TIE EES FE IE OTR SE EI TSE TT COE UE FEE ITE NISRA TENE IE ADOC OS ESOS SSR ED IT OR ESE OLA EEG RRA ES 


VIRTUAL BLOCK 


One of a collection of blocks which make up a user file (or 

the core image of that file). The block is virtual only in x 
that its address (VBN) refers to position within a file ~ 
regardless of the file's allocation or placement on a storage 

medium. When a user accesses a file, he can think of the 

file as a virtual storage medium belonging to him. Virtual 
addressing within that file could be considered to be 

absolute addressing on a virtual medium. 


EHR SRE SRR CRIN OE a ET NE ETE 


ELIT 


LO. 


RELEASE aR DT EEE ELE SEER EG DC GES st 


fe 


a 


INDEX 


Aborting a task, 4-9, 5-13, 7-7, 
8-13 

Accessing UDC11 modules, 11-2 

A/D conversion control word, 10-3 

A/D converter I/O function codes, 

specific, B-4 

A/D converter status returns, 10-8 

Address, logical, D-2 

Address, virtual, D-4 

A/D functional capabilities, 10-10 

A/D gain ranges, use of, 10-11 

Adjusting buffer pointers, 12-13 

A/D programming hints, 10-11 

A/D value, switch gain, 12-14 

ADO1-D analog to digital converter, 
10-2 


- ADOI-D conversions, restricting the 


number of, 10-11 


' AFC1I1 analog-to digital converter, 


10-1 
AFC11, identical channel numbers 
on the, 10-11 . 
AFC11 sampling rate, 10-11 
Alphanumeric format (026 and 029), 
8-11 
ALUNS macro, 1-16 
Analog data, input of, 10-6, 11-18 
Analog input channels, reading 
sequential, 10-6, 11-19 
Analog output, performing, 11-19 
Analog-to-digital converter, 10-2, 


“11-8 
Analog-to-digital converter, AFC11, 
10-1 
Analog-to digital converter drivers, 
10-1, A-~2- j 


ASR-33/35 teletypes, 2-2 

Assembly procedure for UDCOM.MAC, 
11-10 

Assigning a LUN, 1-16 

Assigning a LUN to ADO1, 10-7 

Assigning a LUN to AFO1, 10-7 

Assigning a LUN to LSO, 12-14 

Assigning a LUN to UDO, 11-20 

AST service, terminating, 1-21 

ASTX$SS macro, 1-21 

Asynchronous Line interface, 
DL11-E, 9-2 

Asynchronous process control I/O, 
synchronous and, 10-4, 11-15 

Asynchronous system trap, D-1l 

Attach, D-1l 

Attaching to an I/O device, 1-24 


Binary format, 8-12 

Block, I/O status, D-2 

Block length, 6-9 

Block, logical, D-2. 

Block number, logical, D-3 
Block, reading a logical, 1-25 
Block, reading a virtual, 1-26 
Block size, 5-12 

Block, virtual, D-4 

Block, writing a logical, 1-26 
Block, writing a virtual, 1-27 


- Buffer, circular, 11-26, 11-27, 11-32 


Buffer management, 12-34 

Buffer, output, 12-21 

Buffer pointers, adjusting, 12-13 

Buffer, reading data from an input, 
12-20 . 

Buffers, control and data, 10-10 


Cancelling I/O requests, 1-25 

Capabilities, functional, 8-10 

Card input errors and recovery, 8-4 

Card limitation, input, 8-13 

Card reader check recovery, ready 
and, 8-7 

Card reader data formats, 8-1l 

Card reader driver, A-2 

Cassette driver, 6-1, A-2 

Cassette I/O function codes, 
specific, B-4 

Cassette recovery procedures, 6-7 

Cassette tape, structure of, 6-7 

Changing LUN Assignments, 1-5 

Channel numbers on the AFC1I1,. 
identical, 10-11 

Channel, reading a single A/D, 12-12 

Channels, reading sequential analog 
input, 11-19 

Characters, control, 2-8, 8-10 

Characteristics, tape, 5-5 

Checkpointable tasks, 11-31 

Circular buffer, 11-26, 11-27, 11-32 

Clock and sampling rates, 12-33 

Code conversion, ESCape, 2-12 

Codes, directive, B-3 

Codes, I/O function, B-3 

Codes, return, 1-28 

Codes, specific communication I/O 
function, B-5 

Common block, 11-14 

Common block, linking a task to the 
UDC11, 11-14 
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Communication drivers, A-2 

Communication I/O function codes, 
specific, B-5 

Communications drivers programming 
example, 9-9 

Communications drivers programming 
hints, 9-8 

Conditions, directive, 1-29 

Conditions, I/O, status, 1-31 

Contact interrupt data, reading, 


11-26 

Contact interrupt point, reading a, 
11-25 

Connecting to contact interrupts, 
11-20 

Connecting to timer interrupts, 
11-21 

Contact interrupt digital input, 

. 11-5 

Contact interrupts, connecting to, 
11-20 ; 

Contact interrupts, disconnecting 
from,. 11-22 


Contact sense fields, reading 
several, 11-23 

Control and Data buffers, 

Control characters, 2-8, 8-10 

Control function, RTO2-C, 2-13 

Control word, A/D conversion, 

Converter, analog-to-digital, 
11-8 

Creating a global common block, 
11-12 

Creating the UDC11 driver, 11-1 


10-10 


0-3 


Data formats, card reader, 8-11 
DECtape driver, 4-1, A-3 
DECtape I/O function codes, 
specific, B-5 | 
DECtape recovery procedures, 
DECtape transfers, 4-8 
DECwriters, LA30, 2-2 
DECwriter, LA36, 2-2 
Defining the UDCll configuration, 
- 11-9 
Detach, D-l 
Detaching from an I/O device, 1-24 
Device, attaching to an I/O, 1-24 
Device, detaching from an I/O, 


4-7 


1-24 

Device-specific QIO function, 
4-4, 5-4, 6-3, 8-3, 9-5, 10-2 
11-4, 12-2 


Device specific QIO functions 
(synchronous), 12-4 

Devices, RSX-11M, 1-2 

DH11 asynchronous serial line 
multiplexer, 2-12 

DI1l asynchronous serial line 
interface, 2-12 


Direct access, 11-8 

Direction, speed considerations when 
reversing, 4-9 

Directive, D-1l 

Directive codes, B-3 

Directive conditions, 1-29 

Directive error codes, B-3 

Directive, .MCALL, 1-15 

Directive parameter blocks, 1-12 


Directive success codes, B-3 


Disconnecting from contact inter- 
rupts, 11-22 

Disconnecting from timer inter- 
rupts, 11-23 

Disk driver, 3-1l1l, A-3 

Disk, RF11/RS11 fixed-head, 

Disk, RJP04 pack, 3-2 

Disk, RJSO3 fixed-head, 3-2 

Disk, RJS04 fixed-head, 3-2 

Disk, RK11/RK05 cartridge, 3-2 

Disk, RP11-C/RP03 pack, 3-2 

Display in LED lights, 12-20 

DJ11 asynchronous serial line 
multiplexer, 2-12 

DL11-E asynchronous line interface, 
9-2 

DP11 synchronous line interface, 
9-2 ; 

Driver services, UDC11l, 11-2 

DU11 synchronous line interface, 


i a 


9-3 


End-of-file and IO.SPF, 6-8 
End-of-tape, logical, 6-9 
Errors and recovery, card input, 
8-4 
Error codes, directive, B-3 
Error codes, I/O status, B-1l 
Errors, IO.ADS and ADC, 12-32 
ESCape code conversion, 2-12 
Even-~parity zero, writing and, 
5-13 
Event flag number, D-l 
Event flag, waiting for an, 1-21 
Events, significant, 1-10, D-3 


Flag number, event, D-1 

Floating-point, 12-14 

Format, binary, 8-12 

Format control, vertical, 7-6 

Format, QIO macro, 1-7 

Formats, card reader data, 8-1ll 

Format (026 and 029), alphanumeric, 
8-11 

Fortran interface, 10-4,11-14, 12-9 

FORTRAN interface subroutines, 
LPS11, 12-11 

Fortran interface values, 10-10, 
11-31, 12-32 

Fortran subroutine summary, 
11-16 


10-5, 
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Functional capabilities, 8-10 
Functional capabilities, A/D, 10-10 
Function, IO.ADS, 12-5 
Function, IO.HIS, 12-6 
Function, IO.LED, 12-3 
Function, IO.MDA, 12-7 
Function, IO.MDI, 12-7 
Function, IO.MDO, 12-7 
Function, IO.REL, 12-3 
Function, IO.SDI, 12-4 
Function, I0.SDO, 12-4 
Function, I0O.STP, 12-8 
Functions, summary of, I/0, A-1 


Gain A/D value, switch, 12-14 

Gain ranges, use of A/D, 10-11 

Get LUN information macro, 2-3, 3-2, 
4-1, 5-2, 6-1, 7-2, 8-1, 9-3, 
10-2, 11-3, 12-2 

Global common block, 11-12 

Global common block, creating a, 
11-12 

Glossary, D-1l 

GLUNS macro, 1-18 


Half-duplex considerations, 9-8 

Hints, programming, 2-12, 4-8, 5-12, 
6-8, 7-6, 8-13 

Histogram sampling, 12-17 


Identical channel numbers on the 
AFC11, 10-11 

Importance of rewinding, 6-8 

Initializing a timer module, 11-28 

Input and output, use of ADJLPS for, 
12-35 

Input buffer, reading data from an, 
12-20 

In-progress synchronous function, 
12-21 

Input card limitation, 8-13 

Input, contact interrupt digital, 
11-5 

Input of analog data, 10-6, 11-18 

Input, reading digital, 12-19 

Interface, DI11 asynchronous serial 
line, 2-12 

IO.ADS and ADC errors, 12-32 

IO.ADS function, 12-5 

IO.ATT, 1-24 

I/O completion, 1-27 

IO.DET, 1-24 

I/O function and status codes, 
B-1 

I/O function codes, B-3 

I/O function codes, specific A/D 
converter, B-4 


I/O function codes, specific cassette, 
B-4 


“‘T/O function codes, specific communi- 


cation, B-5 

I/O function codes, specific DECtape, 
B-5 

I/O function codes, specific magtape, 
B-6 

I/O function codes, specific LPS, B-5 

I/O function codes, specific UDC, B-6 

I/O function codes, standard, B-4 

I/O functions, standard, 1-23 

I/O functions, summary of, A-1l 

IO.HIS function, 12-6 

IO.INL, 9-9 

IO.KIL, 1-25 

IO.LED function, 12-3 

IO.INL QIO functions, 9-6 

IO.MDA function, 12-7 

IO.MDI function, 12-7 

IO.MDO function, 12-7 

I/O, Overview of RSX-11M, 1-1 

I/O related macros, 1-13 

IO.REL function, 12-3 

I/O requests, cancelling, 1-25 

I/O request, issuing an, 1-5, 1-15 

IO.RLB, 1-25 

IO.RNS QIO function, 9-6 

IO.RVB, 1-26 

IO.RWU, 5-4 

IO.SDI function, 12-4 

IO0.SDO function, 12-4 

IO.SEC, 5-5 

IO.SPB and IO.SPF, space functions, 
6-9 

IO.SPF, end-of-file and, 6-8 

IO.SPF, space functions, IOLSPB and, 
6-9 

I/O status block, 12-33, D-2 

I/O status conditions, 1-31, 8-8 

I/O status codes, B-l 

I/O status error codes, B-l 

I/O status success codes, B-3 

IO.STP function, 12-8 

I/O status word, 12-31 

I/O, synchronous and asynchronous 
process control, 11-15 

IO.SYN QIO function, 9-6 

IO.TRM QIO functions, 9-6 

IO.WLB, 1-26 . 

IO.WNS QIO function, 9-6 

IO.WVB, 1-27 

ISB status array, the, 10-4, 12-9 

Isb status array, 11-15 

Issuing an I/O request, 1-5, 1-15 


Keys, special, 2-8, 2-9 
KSR-33/35 teletypes. 2-2 
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Laboratory peripheral system driver, 
12-1, A-3 

Latching an output relay, 12-22 

Latching digital output, 11-8 

Latching or unlatching several 

fields, 11-24 

LA30 DECwriters, 2-2 

LA36 DECwriter, 2-2 

LED lights, displaying in, 12-20 

Length, block, 6-9 

Library, system object module, 
11-12 

Lights, displaying in LED, 12-20 

Line printer driver, 7-1, A-4 

Linking a task to the UDC11 common 
block, 11-14 

Logical address, D-2 

Logical block, reading a, 

Logical block number, D-3 

Logical block, writing a, 

Logical end-of-tape, 6-9 

Logical Unit Number, 1-4, D-3 

Logical unit table, 1-4 

Logical units, 1-3 

Low-traffic sync character con- 
siderations, 9-8 

LS11 line printer, 7-2 

LPS I/O function codes, 
B-5 

LPS11, FORTRAN interface subroutines, 
12-11 

LP1l1 line printer, 7-2 

LPS status returns, 12-27 

LUN, assigning a, 1-16 

LUN assignments, changing, 

LUN information, retrieving, 

LUN information macro, get, 
10-2, 11-3, 12-2 

LUN to ADO1, assigning a, 10-7 

LUN to AFO1, assigning a, 10-7 

LUN to LSO, assigning a, 12-14 

LUN to UDO, assigning a, 11-20 

LV11 line printer, 7-2 


1-25 


1-26 


specific, 


15 
1-18 
9-3; 


Message-oriented communication 
drivers, 9-1 
Macro, D-3 
Macro, get LUN information, 2-3, 
3-2, 4-1, 5-2, 6-1, 7-2, 8-1 
Macro, 
ALUNS, 
ASTXSS, 
GLUNS$, 
WTSES, 
QIOS, 1-15 
Macros, I/O-related, 1-13 
Magtape I/O function codes, specific, 
B-6 
Magnetic tape drivers, 5-1, A-4 
-MCALL directive, 1-15 


L=16 
121 

1-18 

1-21 


Multiplexer, DH11 asynchronous serial 
line, 2-12 

Multiplexer, DJ11 asynchronous serial 
line, 2-12 


Number, logical block, D-3 
Number, logical unit, 1-4, D-3 
Numbering conventions, 11-31 
Number of ADO1-D conversions, 
restricting the, 10-11 


Operator interventions, 5-4 

Output buffer, 12-21 

Output, latching digital, 11-8 

Output relay, latching an, 12-22 

Output, synchronous D/A, 12-24 

Output, synchronous digital, 12-26 

Output, writing digital, 12-19 

Output, use of ADJLPS for input 
and, 12-35 

Overview of RSX-11M I/O, 1-1 


Parameter blocks, directive, 1-12 

Parity support, vertical, 9-8 

Performing analog output, 11-19 

Print line truncation, 7-7 

Printer, LP1l line, 7-2 

Printer, LS1l line, 7-2 

Printer, LV11 line, 7-2 

Priority, D-3 

Process control I/O, synchronous 
and asynchronous, 10-4, 11-15 

Programming example, communications 
drivers, 9-9. 


Programming hints, 2-12, 4-8, 5-12, 


6-8, 7-6, 8-13 
Programming hints, A/D, 10-11 
Programming hints, communication 
drivers, 9-8 
Programming hints, UDC1l1, 11-31 
Pulsing several fields, 11-24 


QIOS Macro, 1-15 

QIO macro, 2-5, 3-3, 4-2, 5-3, 6-2, 
7-3, 8-2, 9-4, 10-2, 11-3 

QIO Macro format, 1-7 


QIO functions, device-specific, 4-4 
5-4, 6-3, 8-3, 10-2, 11-4, 12-2, 
12-8 

QIO functions, 

IO.INL, 9-6 
TO.RNS, 9-6 
IO.SYN, 9-6 
IO.WNS, 9-6 

QIO functions, 
6-3, 8-2, 

QIO functions, 
specific, 


standard, 4-2, 5-2, 
9-4, 10-2, 11-3, 12-2 
(synchronous), device- 
12-4 
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Rate, AFC11, sampling, 10-11 

Rates, clock and sampling, 12-32 

Reading a contact interrupt point, 
11-25 

Reading a logical block, 1-25 

Reading a single A/D channel, 12-12 

Reading a timer module, 11-27 

Reading a virtual block, 1-26 

Reading contact interrupt data, 
11-26 

Reading data from an input buffer, 
12-20 

Reading digital input, 12-19 

Reading sequential analog input 
channels, 10-6, 11-19 

Reading several contact sense 
fields, 11-23 

Reading timer interrupt data, 11-27 

Reads and writes, retry procedures 
for, 5-12 

Ready and card reader check 
recovery, 8-7 

Ready recovery, 7-5 

Recovery, card input errors and, 
8-4 

Recovery procedures, cassette, 6-7 

Recovery procedures, DECtape, 4-7 

Recovery, ready, 7-5 

Recovery, ready and card reader 
check, 8-7 

Recovery, select, 4-8, 5-12 

Redundancy checking, 9-8 

Relay, latching an output, 12-22 

Resetting tape characteristics, 
5-13 

Restricting the number of ADO1-D 
conversions, 10-11 

Retrieving LUN information, 1-18 

Retrieving system macros, 1-15 

Retry procedures for reads and 
writes, 5-12 

Return codes, 1-28 

Returns, status, 2-6, 3-4, 4-4, 
5-9, 6-4, 7-4, 8-4 


Reverse reading and writing, 4-8 


Reversing direction, speed 
considerations when, 4-9 

Rewinding, importance of, 6-8 

RF11/RS11 fixed-head disk, 3-1 

RJP04 pack disk, 3-2 

RJSO3 fixed-head disk, 3-2 

RJSO04 fixed-head disk, 3-2 

RK11/RKO05 cartridge disk, 3-2 

RP11-C/RP03 pack disk, 3-2 

RSX-11M Devices, 1-2 

RSX-11M I/O, Overview of, 1-1 

RTO2 alphanumeric display terminal, 
2-3 

RTO2-C badge reader/alphanumeric 
display terminal, 2-3 

RTO2-C control function, 2-13 

RUBOUT character, 7-6 


Sampling, histogram, 12-17 

Sampling rate, AFCll, 10-11 

Sampling rates, clock and, 12-33 

Sampling, synchronous A/D, 12-22 

Sampling, synchronous digital 
input, 12-15 

Schmitt trigger, 12-6 

Select recovery, 4-8, 5-12 

Significant event, 1-10, D-3_ 

Single A/D channel, reading a, 
12-12 

Size, block, 5-12 

Space functions, IO.SPB and IO.SPF, 
6-9 

Special keys, 2-8, 2-9 . 

Specific A/D converter I/O function 
codes, B-4 

Specific cassette I/O function codes, 
B-4 

Specific communication I/O function 
codes, B-5 oe 

Specific DECtape I/O function codes, 
B-5 . 

Specific LPS I/O function codes, B-5 

Specific magtape I/O function codes, 
B-6 

Specific UDC I/O function codes, B-6 

Speed considerations when reversing 
direction, 4-9 

Standard I/O functions, 1-23 

Standard I/O function codes, B-4 

Standard QIO functions, 4-2, 5-3, 
6-3) 8=2;- 9-4, 10-27 11-2, 12-2 

Status array, ISB, 12-9 

Status block, I/0, 12-33, D-2 

Status codes, I/O, B-1l 

Status codes, I/O function and, B-1l 

Status condition, I/0, 1-31, 8-8 

Status error codes, I/O, B-1 

Status returns, 2-6, 3-4, 4-4, 5-9 
6-4, 7-4, 8-4, 9-7 

Status returns, A/D converter, 10-8 

Status returns, LPS, 12-27 

Status returns, UDC11, 11-28 

Status success codes, I/O, B-3 

Status word, I/O, 12-31 

Structure of cassette tape, 6-7 

Success codes, Directive, B-3 

Success codes, I/O status, B-3 

Summary of I/O functions, A-1l 

Switch gain A/D value, 12-14 

Symbols defined by UDCOM.MAC, 11-10 

Sync character considerations, low- 
traffic, 9-8 

Synchronous A/D sampling, 12-22 

Synchronous and asynchronous process 
control I/O, 10-4, 11-15 

Synchronous D/A output, 12-24 

Synchronous, device-specific QIOo 
functions, 12-4 

Synchronous digital input sampling, 
12-15 
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Synchronous digital output, 12-26 

Synchronous function, in-progress, 
12-21 

Synchronous line interface, DP1l, 9-2 

Synchronous line interface, DUI11, 
9-3 

Synchronous subroutines, 12-10 

Synchronous system trap, D-4 

System macros, retrieving, 1-15 

“System object module library, 11-12 

System traps, 1-11 

System trap, synchronous, D-4 


Table, logical unit, 1-4 

Tape characteristics, 5-5 

Tape characteristics, resetting, 
5-13 

Tape, structure of cassette, 6-7 

Tape, TJ16 magnetic, 5-2 

Tape, TM11 magnetic, 5-2 

Teletypes, ASR-33/35 

Teletypes, KSR-33/35 

Terminal driver, 2-1, A-5 

Terminal line truncation, 2-12 

Terminal, RTO2 alphanumeric display, 
2-3 

Terminal, RT02-C badge reader/ 
alphanumeric display, 2-3 

Terminal, VT50 alphanumeric 
display, 2-3 

Terminal, VTO5B alphanumeric 
display, 2-3 

Terminating AST service, 1-21 

The Isb status array, 10-4 

Timer, 11-7 

Timer interrupt data, reading, 
11-27 

Timer interrupts, connecting to, 
11-21 

Timer interrupts, disconnecting 
from, 11-23 

Timer module, initializing a, 11-28 

Timer module, reading a, 11-27 

TJ10 magnetic tape, 5-2 

TM11 magnetic tape, 5-2 

Transmission validation, 9-8 

Trap, asynchronous system, D-1l 

Trap, synchronous system, D-4 

Traps, System, 1-1 

Truncation, print line, 7-7 
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UDC I/O function codes, specific, B-6 

UDC11 configuration, defining the, 
11-9 

UDC11 driver, creating the, 11-1 

UDC1l driver services, 11-2 

UDC1l modules, accessing, 11-2 

UDC1l programming hints, 11-31 

UDC11 status returns, 11-28 

UDC11 symbolic definitions, 11-12 

Unit number, logical, D-3 

Universal digital controller driver, 
ll-1, A-5 

Unlatching several fields, latching 
or, 11-24 

Use of A/D gain ranges, 10-11 

Use of ADJLPS for input and output, 
12-35 


Verification of write operations, 
6-9 

Vertical format control, 7-6 

Vertical parity support, 9-8 

Virtual address, D-4 

Virtual block, D-4 

Virtual block, reading a, 1-26 

Virtual block, writing a, 1-27 

VT50 alphanumeric display terminal, 
2-3 

VTO5B alphanumeric display terminal, 
2-3 


Waiting for an event flag, 1-21 
Write operations, verification of, 


6-9 
Writes, retry procedures for reads 
and, 5-12 


Writing a logical block, 1-26 
Writing and even-parity zero, 5-13 
Writing a virtual block, 1-27 
Writing digital output,, 12-19 
Writing, reverse reading and, 4-8 
WTSES macro, 1-21 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 


The Software Communications Group, located at corporate headquarters in 
Maynard, publishes software newsletters for the various DIGITAL products. 
Newsletters are published monthly, and keep the user informed about cus- 
tomer software problems and solutions, new software products, documenta- 
tion corrections, as well as programming notes and techniques. 


There are two similar levels of service: 


: The Software Dispatch 
: The Digital Software News 


The Software Dispatch is part of the Software Maintenance Service. This 
service applies to the following software products: 


PDP-9/15 
RSX-11D 

DOS /BATCH 
RSTS-E 
DECsystem-10 


A Digital Software News for the PDP-11 and a Digital Software News for 
the PDP-8/12 are available to any customer who has purchased PDP-1l or 
PDP-8/12 software. 


A collection of existing problems and solutions for a given software 
system is published periodically. A customer receives this publication 
with his initial software kit with the delivery of his system. This 
collection would be either a Software Dispatch Review or Software Per- 
formance Summary depending on the system ordered. 


A mailing list of users who receive software newsletters is also main- 
tained by Software Communications. Users must sign-up for the news- 
letter they desire. This can be done by either completing the form sup- 
plied with the Review or Summary or by writing to: 


Software Communications 


P.O. Box F 
Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 

Questions or problems relating to DIGITAL's software should be reported 
as follows: 

North and South American Submitters: 

Upon completion of Software Performance Report (SPR) form remove last 
copy and send remainder to: 


‘Software Communications 
P.O. Box F 
Maynard, Massachusetts 01754 


The acknowledgement copy will be returned along with a blank SPR form 
upon receipt. The acknowledgement will contain a DIGITAL assigned SPR 
number. The SPR number or the preprinted number should be referenced in 
any future correspondence. Additional SPR forms may be obtained from 
the above address. 


All International Submitters: 


Upon completion of the SPR form, reserve the last copy and send the re- 
mainder to the SPR Center in the nearest DIGITAL office. SPR forms are 
also available from our SPR Centers. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In the 
United States, send orders to the nearest distribution center. 
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Digital Equipment Corporation Digital Equipment Corporation 


Software Distribution Center Software Distribution Center 
146 Main Street 1400 Terra Bella 
Maynard, Massachusetts 01754 Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computers Users Society, maintains a user ex- 
change center for user-written programs and technical application infor- 
mation. The Library contains approximately 1,900 programs for all 
DIGITAL computer lines. Executive routines, editors, debuggers, special 
functions, games, maintenance and various other classes of programs are 
available. 


DECUS Program Library Catalogs are routinely updated and contain lists 
and abstracts of all programs according to computer line: 


° PDP-8, FOCAL-8, BASIC-8, PDP-12 
e PDP-7/9, 9, 15 
° PDP-11, RSTS-11 


. PDP-6/10, 10 


Forms and information on acquiring and submitting programs to the DECUS 
Library may be obtained from the DECUS office. 


In addition to the catalogs, DECUS also publishes the following: 


DECUSCOPE ' -The Society's technical newsletter, published bi-monthly, 


aimed at facilitating the interchange of technical in- 
formation among users of DIGITAL computers and at dis- 


seminating news items concerning the Society. Circula- 


tion reached 19,000 in May, 1974. 
PROCEEDINGS OF -Contains technical papers presented at DECUS Symposia 


THE DIGITAL held twice a year in the United States, once a year 
EQUIPMENT USERS in Europe, Australia, and Canada. 

SOCIETY 

MINUTES OF THE -A report of the DECsystem-10 sessions held at the two 
DECsystem-10 United States DECUS Symposia. 

SESSIONS 

COPY-N-Mail ~A monthly mailed communique among DECsystem-10 users. 
LUG/SIG ~Mailing of Local User Group (LUG) and Special Interest 


Group (SIG) communique, aimed at providing closer 
communication among users of a specific product or 
application. 


Further information on the DECUS Library, publications, and other DECUS 
activities is available from the DECUS offices listed below: 


DECUS DECUS EUROPE 

Digital Equipment Corporation Digital Equipment Corp. International 
146 Main Street (Europe) 

Maynard, Massachusetts 01754 P.O. Box 340 


1211 Geneva 26 
Switzerland 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repcrt (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


> 
l¢ 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer | 


000000 


Non-programmer interested in computer concepts and capabilities 


NAMC 2 ee ee | Date 


Organization 
Street 
Cl ty i Sa Ip’ Code™) 
or 
Country 


If you do not require a written reply, please check here. C) 
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